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PREFACE 
to the Second Edition 


In the months since this manual first appeared, many changes have 
occurred both in the system itself and in the way it is used. 


Perhaps most obviously, there have been additions, deletions, and 
modifications to the system and its software. It is these 
Changes, of course that caused the appearance of this revised 
manual. | 


Second, the number of people spending an appreciable amount of 
time writing UNIX software has increased, Credit is due to 

L. Le Cherry, M. D. McIlroy, L. E. McMahon, R, Morris, and 

J. F. Ossanna for their contributions. 


Finally, the number of UNIX installations has grown to 10, with 
more expected. None of these has exactly the same complement of 
hardware or software, Therefore, at any particular installation, 
it is guite possible that this manual will give inappropriate 
information. One area to watch concerns commands which deal with 
special files (I/o devices). Another is places which talk about 
such things as absolute core locations which are likely to vary 
with the memory configuration and existence of protection 
hardware. Also, not all installations have the latest versions 
of all the software. In particular, the assembler and loader 
have just undergone major reorganizations in anticipation of a 
UNIX for the PDP-11/45. 


a 


Ceara  memamp cement te 
He 
SS 


INTRODUCT ION 


This manual gives descriptions of the publicly available features 
of UNIX. It provides neither a general overview (see The UNIX 


-4me-sharing System for that) nor details of the implementation 


of the system (which remain to be disclosed). 


within the area it surveys, this manual attempts to be as Ccom— 
plete and timely as possible. A conscious decision was made to 
describe each program in exactly the state it was in at the time 
jts manual section was prepared, in particular, the desire to 
describe something as it should be, not as it is, was resisted. 
Inevitably, this means that many sections will soon be out of 
date. (The rate of change of the system is so great that a 
Gismayingly large number of early sections had to be mod if ied 
while the rest were being written. The unbounded effort required 
to stay up-to-date is best indicated by the fact that several of 
the programs described were written specifically to aid in 
preparation of this manual ! ) 


This manual is divided into seven sections: 


Le Command s 

Ti. System calls 

TII. Subroutines 

Iv. Special files 

Ve File formats 

Vi. User-maintained programs 
VII. Miscellaneous 


Commands are programs intended to be invoked directly by the 

user , in contradistinction to subroutines, Which are intended to 
pe called by the user’s programs. Commands generally reside in 
directory /pin (for binary programs ). This directory is searched 
automatically by the command line interpreter. Some programs 
classified as commands are located elsewhere; this fact is indi- 
cated in the appropriate sections. 


System calls are entries into the UNIX supervisor. in assembly 
language, they are coded with the use of the opcode SyS » @ 
synonym for the trap instruction. | 


A small assortment of subroutines is available; they are e 
aGescribed in section III. The binary form of most of them is 
kept in the system library /usr/lib/liba.a. 


The special files section Iv discusses the characteristics of 
each system file which actually refers to an I/o device. 


The file formats section V documents the structure of particular 
kinds of files; for example, the form of the output of the loader 
and assembler is given. Excluded are files used by only one com— 
mand, for example the assembler’s intermediate files. 
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User-maintained programs (section VI) are not considered part of 
the UNIX system, and the principal reason for listing them is to 


indicate their existence without necessarily giving a complete 
description. The author should be consulted for information. 


The miscellaneous section (VIL) gathers odds and ends. 


Each section consists of a number of independent entries of a 
page or so each. The name of the entry is in the upper right 
corner of its pages, its preparation date in the upper left. 
Fntries within each section are alphabetized, It was thought 
better to avoid running page numbers, since it is hoped that the 
manual will be updated freguently. Therefore each entry is nun- 
bered starting at page 1. ) 


All entries have a common format. 


The name section repeats the entry name and gives a very 
short aescription of its purpose. 


The synopsis summarizes the use of the program being 
described. A few conventions are used, particularly in the 
Commands section: | 


Underlined words are considered literals, and are typed 
just as they appear. 


Square brackets ({]) around an argument indicate that the 
argument is optional. When an argument is given as 
name:, it always refers to a file name. 


Fllipses "... are used to show that the previous 
argument—prototype may be repeated. 


A final convention is used by the commands themselves. 
An argument beginning with a minus sign "_" gs often tak- 
en to mean some sort of flag argument even if it appears 
in a position where a file name could appear. Therefore, 
it is unwise to have files whose names begin with -—- .e 


The description section discusses in detail the subject at 
hand. 


Te files section gives the names of files which are puilt 
into the program, 


za see also section gives pointers to related information. 

A diagnostics section discusses the diagnostics that may be 
produced, This section tends to be as terse as the diagnos— 
tics themselves. 

The bugs section gives known bugs and sometimes deficien- 


cies. Occasionally also the suggested fix is described. 
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The owner section gives the name of the person or persons to 
be consulted in case of difficulty. The rule has been that 
the last one to modify something owns it, so the owner is 
not necessarily the author. The owner’s nicknames stand 


for: 
ken K, Thompson 
dmr D. M, Ritchie 
jfo g. F. ossanna 
rhm R, Morris 


doug M. D. McIlroy 
lem Ls. Be McMahon 
lic L. L. Cherry 

csr Ce. Se Roberts 


These nicknames also happen to be UNIX user ID’s, so mes~ 
sages may be transmitted by the mail command OF, if the 
addressee is logged in, by write. 


At the beginning of this document is 4 table of contents, organ 

ized by section and alphabetically within each section. There is 
also a permuted index derived from the table of contents. Within 
each index entry, the title of the writeup to which it refers is 

followed by the appropriate section number in parentheses. This 

fact is important because there is considerable name duplication 

among the sections, arising principally from commands which exist 
only to exercise 4 particular system call. 


This manual was prepared using the UNIX text editor ed and the 
formatting program rofft. 
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TABLE OF CONTENTS 
I. COMMANDS 


© cece eee ecscceccvecsesseeses place label 

ACCEL cecccccccccscscsecseseer® get connect—time account ing 
AY ceceseccessveeveseeeere® &® archive ( combine) files 

AS cecccccccccccessesecserre® assembler 

DAS eceocosseessesesseeeeeeee® & BASIC dialect 

Cat ecccccccccecescveccsseee® concatenate (or print) files 
cc eccccceveesecesesreeserer e® & compile Cc program 

ChHaixC ceceesveeveeserererrre%® change working Girectory 
Check cecccccccccsesessesser® check consistency of file system 
Chmod eeccccscccecsscssserese® change access mode of files 
CHOWN eecccccccscscceserserr® change owner of files 

CMPD scccccccvccesoseesesesee® compare file contents 

Cp Pee ee CcCOpy file 

Gate ceoceccecesseseeeerrerer%® get date and time of day 

Ab ceccccccccccssccsessssses® symbolic debugger 

dc eee ee ee ee ee desk calculator 

at eoccecccsseeceoseoseseeeee® find free aisk space 

dpd eoceeccesceseoseseseeeree® spawn data-—phone Gdaemon 

GS ceccecccccccsccccsesesese® verify directory hierarchy 
ASW ceoccccceseseseoeesesers® & delete files interactively 
Gu cccvssecnewsows eoeeoe teeny = dqdisk usage 

echo Ss uns aatenteleeiauies 6OR ECS, Pe Le command arguments 

ed sind Bikes aloute aie atone eee ee ee ce editor 

exit cates ctieeseeweoeees 07 Commane sequence 

fc er re ee eee compile Fortran program 

fed ids sktaeeeaeaueesaes ss form—-letter editor 

Find ceeocecscceesssseseeresrere® find file with given name 
FOOCM ecvccsesseeseeeevesere? & generate form letter 

goto ccc cccccceersesereee eee &@ command transfer 

Sf 6 :¢60.0 60 00.0 6 6:0 6400 Oe Oe Re ETS conditional command 

istat cece cece cccsesesesesee® file status by i-—number 

1d Slee o e160 020-46 6 006-6188 089.98. 5° link editor (loader) 

In cecccccccccsecsscssesesee® link to file 

login eoecescesesesesreeseee ee © log on to system 

LS ccccccceveeveseesesereere® list contents of airectory 
mail coc cc ccc sesesseessesere® send mail to another user 
man ~ i hue Lae EOUES eee Cees “ST off manual section 

mesg eocesccesseseoesesere ee” permit or deny messages 
mKGiX coessceseeseeseeeeere%%® create directory 

Mount eeccoecseeseseeeeeerer®® mount detachable file system 
mt OP ee ee ee ee de a save/restore files on magtape 
MV eccoccsecseseseoeserereee%® move or rename file 

m6 eee cen eoesaeseesseeeeeeee® macroprocessor 

nm ccc cc ccccesccsescssesese® print namelist 

NLOFE cecccccsccesecssessese® format text for printing 
OG coccccecsevesesereeserrere®® octal dump of file 

Opr ee eee i ta print file off—line 

OV LW Li nee se heeeyeoneseees page overl ay file print 

pr coc ecccseceesreeseseserrre &®% print file with neadings 
COW ccoccsseceseseverereeeee%% ® rewind DECt ape 

rm cece cece seseeseersesese ee ® remove (delete) file 


oe, * a 


LMLL secccscveceeseseerrrr%%® 
rofrft Coe sw ecee ee Coes. es eee er" 
salv <igig al eee eae 62 O28 8 OO 
sh sco ccccnveccsesssserese ce” 
SOTt eoccesocsccsssrserrree*” 


stat 


strip PP ee a ee oe ea 


stty Pe ee ee ns 
su - eigigiee eee ee wes ee aee-e ees ee? 
sum er ae 


tacct 


tap wcccceceseseessererere%%® 


tm ee ee 
tss Pe ee 
tty spss seereereeee ees ee eo 7 


type Seedroweseoeooeoesoesr ec” 
umount gig grew eee eee 6 oe eee 8S SS 
un 


Le ete wpiee eee 6 ee Srerotere Se SS 
wc opened eee ee eee Cee eee ee es 


who Pe ne 


write Cigale le Ge ee a 8 8 Oe Oe 8-8-8: Se” 


TI. SYSTEM CALLS 


br eak eeecensccseesceceseess 
cemt «dca eer eee wee 2 eee Se er te 


chd ir 


chmod ccc ccscccsescseeese® 


chown cgesseeeeosovesesoero et” 
close wee ccsccecsoesesesesee® 
creat ee ee 
ex ec ecccscesececssaneaseres® 
exit s6ertscroseseccseeseee® 
fork re 
fstat eccccccceccsesessee eee” 
getuid cee eeoecereeaswoees ye” 
tty seccscceesosessseerseee® 


hog Oe ee a a ea 
G1lginS ceseeceeecees 
intr 


link Re re 
kill eget etaceseseoces ee 9 


makdir 


maiate Leceeosecetceeeeoeeee ee ®t 


mount go weed ee ese see eeres ere” 
open emcee eceseesesessesereee® 
quit eveseccsccsesosseeserre® 
r ead eccccecessseooseeseeseee® 
rele ce ae wae ee 66 eee eee 8 eo" 
SECK coccccccccscosseesserrre® 


setuid 


sleep POP ee ee ee 0 


cocesecccceseseseser®%® 


stat meee cecessoseocssssesors® 


stime 


stty PP ee ee deal 


ccc ce ccseeeeveeseeree%® 


remove (delete) directory 
format text for printing 
repair damaged file system 
command interpreter 

sort ASCII file 

get file status 

remove symbols, relocation bits 
set typewriter modes 

become super—-user 

sum file 

connect—time accounting 
manipulate DECt ape | 

get time information 
communicate with MH-TSS (GCOS) 
find name of terminal 

print file page-by-page 
dismount removable file system 
find undefined symbols 

get (English) word count 

who is on the system 

write to another user 


set program br eak 
catch EMT traps 
change working directory 
change mode of file 
change owner of file 
close open file 
create file 

execute program file 
terminate execution 
create new process 
status of open file 


get user WD 


get typewriter mode 

set low-priority status 

catch illegal instruction trap 
catch or inhibit interrupts 


link to file 


destroy process 

create directory 

set date modified of file 
mount file system 

open file 

catch or inhibit quits 
read file 

release processor 

move read or write pointer 
set user ID 

delay execution 


\ 


‘get file status 


set system time 
set mode of typewriter 
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sync eer assure synchronization 
tell K@e@oses sees eeecese eo o* find read or write pointer 
time ccc resecscesocossserese®® get time of year 

umount cgtaee estes @eceee se eee t” Aaismount file system 
UNLINK eeveccccosessrrserere® remove (delete) file 

wait ceccecccsccsssecsserere® wait for process 

WAITS ceccccccsscscsoserrrr®® write file 


III. SUBROUTINES 


atan Kjeses ee eeress eer ere s*”™ arctangent 

BEOE. dnccddk base canes seeseee* convert ASCII to floating 
atoi ccc cesoceseseveseseoss ee” convert ASCII to integer 
CONSE coccccccccssceseseeree® floating-point constants 
CLAIME seocccccsceserserereeee® convert time to ASCII 

exp socceeeesssesoseoreseee’® exponential function 
FPtTAP escceseresccesseesere® floating-point simulator 
FEOA cecccccsesscosesererses® convert floating to ASCII 
gerts ecesesccvevserseseesee® communicate with GCOS 
getc u Lug ig ete:e ee ee eee So 8 e288 Fe get character 

NypOt secccsescesecessereeree® compute hypotenuse 

itoa LGig@essesewese sess ee ewes convert integer to ASCII 
log Li tg gitaigh Gia Oe we S O:8 OS SPSS NY logarithm pase e€ . 
mesg Ls dave gaging sipeeeeale ae print string on typewriter 
nlist ~@ser ewes O88 6S CO SS eee 8 read name list 

ptime coceeceeseccessoeoe ee e® print time ; 
PUEC soceccccceccesssrcseree® write character or word 
qsort eccececccencesesseree® & quicker sort 

SALION ceccccccccccsseseorre® storage allocator 

sin sees eecensooeneoosorne” sine, cosine 

sqrt Lk gale ee ce asiesiese sess square root 

switch cece cece sec essesesese® transfer depending on value 


Iv. SPECIAL FILES 


dnO ppgeceseewee se ee cee" 801 ACU | 

dpO ecceeceesceseseoseneesese® 201 Dataphone 

lpr ecocseeeseseseseenerrere® line printer 

mem <lgitg e/a eres Oa eS 908 8 FOS S'S ee core memory 

mtO - eee estossssecewreses ss magtape 

Dpt (csecesseeeseweeesrrrr’ *” punched paper tape 
rfO core esseceossseneoseeree® RF disk 

rkO —{eewesees eer eee eeres ers” RK disk 

rpO cL bGeetese sw ee oes ee eeees ss” RP disk 

tap0O ecco scesceeeseseerosee® & DECt ape 

tty 6esess eevee eroeroor sore” console typewriter 
tty0 ung geese ee eee 6 08 Se 8:9 89° remote typewriter 


V. FILE FORMATS 
a,out < caemaaaneeeeaenrmeee Gaegee =. and loader output 
archive ecoecceeseseseses eee? ® archive file 


CITE ceoccccscseccssssseseeee® core image file 
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airectory eceseeeveeeveeereee%® 
file system eoceeeseeeeeeee %% 
ident ecoceeseessessrereerer®® 
passwd cece cc cccccsescssesee® 
tap wcocccccccseccoseerseeree® 
uids coc eccccccecsosoesesere® 
utmp egw eee 6 6.00 66/0 6 0 4-08 O° * 


wtmp eccccsesecccoseserser ee ® 


vi. USER MAINTAINED PROGRAMS 


basic igie-e be 6 20 6:0: 06 @ 0:09:00 9 °° 
DC acacasseseseoessgesoseree® 
bj on pgp ee eee se owes eee se 2? 
cal a 
chash sees e weve ceoneeoeosrorre” 
cref eeccesceeeeseceeeseeere® 
aas eee cet eee eeeeeeeces cere” 
ali (a6 4 SS OSS © OOO SESE OD OP 
apt ighesawsweaness see ss 
moo Loca pasreseseseereroor re” 
ptx Pr ee ee ee ee ae 
tmg Pe ee ee 


ttt meee evesseceseeseseeeee%® 


Vil. MISCELLANEOUS 


ascil pec cccccccscceccesseer? 
bproc ecccccevcsseseseeeereee® 
getty ececcsccecsececececeseeeeeeere® 
GlOb. eocccceescesserrrrrrere”® 
init ceeccseccccesssesereeee%® 
kbd eee eee e oe eee 66 C02 6 eee ee” 
login eee cc ccc ccccscccsceses 
msh ereceescoscsseenssesesee® 


tabs evecscccccsoensesseseee® 


directory format 

file system format 

Gcos ident cards 

password file 

DECt ape format 

map names to user ID‘s 
logged-in user information 
accounting files 


DEC supplied BASIC 

compile B program 

the game of black jack 
print calendar 

prepare symbol table 
cross-reference table 
disassembler 

load DEC binary paper tapes 
rea@ DEC ASCII paper tapes 
the game of MOO 3 
permuted index 

compile tmgl program 

the game of tic-tac-—toe 


map of ASCII 

boot procedure 

adapt to typewr iter 
argument expander | 
initializer process 

map of TTY 37 keyboard 

how to log onto system 
mini Shell 

set tab stops on typewriter 
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chmod(I): change 

wtmp(V): 

acct(I): get connect-—time 
tacct(I): connect-—time 


anO(Iv): 801 
getty(VII): 

salloc( III): storage 
mail(I): send mail to 
write(I): write to 
ar(I): 

archive(Vv): 


atan(III): 
glob(VII): 
echo(I): print command 


sort(I): sort 
apt(VI): read DEC 
atof(III): convert 
atoi(III): convert 


ascii(VII): map of 
ctime(III): convert time to 
convert floating to 

jtoa( III): convert integer to 


a,out(V): 
as(I): 
sync(II): 


be(VI): compile 
log( III): logarithm 


bas(I): 
pasic(VI): DEC supplied 


su( I): 
@ali(VI): load DEC 
remove symbols, relocation 


bj(VI): the game of 
pproc( VII): 


set program 


br eak( II): 
¢ file status 


istat(TI) 


INDEX 


s(I): place label 

a.out(V):; assembler and loader output 
access mode of files 

accounting files 

account ing 

accounting 

acct(I): get connect-time account ing 
ACU 

adapt to typewriter 

allocator 

another user 

another user 

archive (combine) files 

archive file 

archive(V): archive file 
arctangent 

argument expander 

arguments 
ar(I): archive 
ASCII file 
ASCII paper tapes 

ASCII to floating 

ASCII to integer © 

ascii(VII): map of ascit 

ASCII 

ASCII | 

ASCII...ftoa( III): 

ASCII 

as(I): assembler 

assembler and loader output 
assembler — 

assure synchronization 
atan(III): arctangent 

atof(III): convert ASCII to floating 
atoi(III): convert ASCII to integer 
B program 

base e 

pas(I): BASIC dialect 

BASIC dialect © 

pasic(VI): DEC supplied BASIC 
BASIC _ 

be(VI): compile B program 

become super—user 

binary paper tapes 
bits...strip(I): 

bj(VI): the game of black jack 
black jack 

boot procedure 

bproc(VII): boot procedure 
preak(II): set program break 

br eak 

by i-number 


(combine) files 


=a = 


ec(I): compile 
ac(I): desk 
cal(VI): print 


jaent(V): GCOS ident 


cemt( II): 


ilgins(II): 
intr( II): 
quit( II): 


chmod (I): 
chmod( II): 
chown( I): 
chown(II): 
chdir(I): 
chdir(II): 
pute(III): write 
getc(III): get 


check(I): 


close(II): 


ar(I): archive 
echo(I): print 
sh(I): 

exit( I): end 
goto(I): 

if(I): conditional 
gerts( III): 
tss(I): 

cmp( I): 

be(VI): 

ec(I): 

fc(I): 

tmg( VI): 

hypot( III): 
cat( I): 

if(I): 

acct(I): get 
tacct( I): 
check(I): check 
tty(Iv): 

const( III): floating-point 


ls(I)s: list 
cmp( I): compare file 


Cc program 

calculator 

calendar 

cal(VI): print calendar 

cards 

catch EMT traps 

catch illegal instruction trap 
catch or inhibit interrupts 

catch or inhibit quits 

cat(I): concatenate (or print) files 
cc(I): compile C program 
cemt(II): catch EMT traps 

change access mode of files 

change mode of file 

change owner of files 

change owner of file 

change working directory 

change working directory 

Character or word 

character 7 

chash(V1I): prepare symbol table 
chair(1I): change working Girectory 
chdair(II): change working directory 
check consistency of file system 
check(1I): check consistency of file system 
chmod(I): change access mode of files 
Chmod(II): change mode of file 
chown(I): change owner of files 
chown(II): change owner of file 
close open file 

close( II): close open file 

cmp(I): compare file contents 
(combine) files 

command arguments 

command interpreter 

command sequence 

command transfer 

command : 

communicate with GCOS 

communicate with MH-TSS (GCOS ) 
compare file contents 

compile B program 

compile C program 

compile Fortran program 

compile tmgl program 

compute hypotenuse 

concatenate (or print) files 
conditional command 

connect-time accounting 
connect—time accounting 
consistency of file system 

console typewriter 

constants 

const( III): floating-point constants 
contents of directory 

contents 
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atof (III) 
atoi( III) 
ftoa( III) 
jtoa( III) 
ctime( III) 
cp(T) 
core(V) 
mem( IV ) 
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sin(III): sine, 
we(I): get (English) word 


makdir( II): 
mkdir(I): 
creat(II): 
fork( II): 


cref(VI): 


dpd(I): spawn data-phone 
salv(I): repair 


Apd( I): spawn 
apO( Iv): 201 
date(I): get 

mdate(II): set 


date(I): get date and time of 


ab(I): symbolic 
dpt(VI): read 
dli(VI): load 
pasic(VI): 

tap(V): 

rew(I): rewind 
tap(I): manipulate 
tapO( IV): 
sleep(II): 
rmdir(I): remove 

| dsw(I): 

rm(I): remove 
unlink( II): remove 
mesg(I): permit or 
switch(III): transfer 
dc(I): 

kill( II): 

mount (I): mount 


bas(I): BASIC 
directory(V): 
as(I): verify 


chdir(I 


): change working 
chadir( II): 


change working 


ASCII to floating 
ASCII to integer 
floating to ASCII 
convert integer to ASCII 
convert time to ASCII 

copy file 

core image file 

core memory 

core(V): core image file 
cosine 

count 

cp(I): copy file 

create directory 

create directory 

create file 

create new process 

creat(II): create file 
cref(VI): cross-reference table 
cross-reference table 
ctime(III): convert time to ASCII 
daemon 

damaged file system 

das(VI): disassembler 
data-phone daemon 

Dataphone 

date and time of day 

Gate modified of file 

date(I): get date and time of day 
day | 
db(I): symbolic debugger 
de(1I): desk calculator 
debugger 

DEC ASCII paper tapes 

DEC binary paper tapes 

DEC supplied BASIC 

DECtape format 

DECt ape 

DECt ape 

DECt ape 

delay execution 

(delete) directory 

delete files interactively 
(delete) file 

(delete) file 

deny messages 

depending on value 

desk calculator 

destroy process 

detachable file system 
af(I): find free disk space 
Gialect 

Girectory format 

directory hierarchy 
directory(V): directory format 
Girectory 

Girec‘ ory 


convert 
conv ert 
convert 
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ls(I): list contents of 
 makdir(II): create 
mkdir(I): create 
rmdir(I): remove (delete) 
das(VI): 

af(z): find free 

du(I): find 

rfO(IV): RF 

rkO(IV): RK 

rpO(IV): RP 

umount (II): 

umount (I): 


od(I): octal 


1a(I): link 

ed(I): text 

fed( I): form-letter 
cemt( II): catch 
exit( I): 

we(I): get 


exec( II): 
exit( II): terminate 
gleep(II): delay 


glob(VII): argument 


exp( III): 
log(III): logarithm base 


emp(I): compare 
opr(I): print 
type(I): print 
ov(I): page overlay 
istat(I): 

stat(I): get 

stat( II): get 

file system(V): 


check consistency of 

mount (I): mount detachable 
mount(II): mount 

salv(I): repair damaged 
umount (I): dismount removable 
umount(II): dismount 


directory 

aGirectory 

directory 

directory 

disassembler 

disk space 

disk usage 

disk 

disk 

disk 

dismount file system 

dismount removable file system 
ali(VI): load DEC binary paper tapes 
anO( Iv): 801 ACU | 

dpd(I): spawn data-phone daemon 
apt(VI): read DEC ASCII paper tapes 
apO(IV): 201 Dataphone | 
ds(1I): verify directory hierarchy 
dsw(I): delete files interactively 
du(I): find disk usage 

dump of file 

echo(I): print command arguments 
ed(I): text editor 

editor (loader) 

editor 

editor 

EMT traps 

end command sequence 

(English) word count 

exec(II): execute program file 
execute program file 

execution 

execution 

exit(I): end command sequence 
exit( II); terminate execution 
expander : 

exp(III): exponential function 
exponential function 


e 
fc(I): compile Fortran program 
fed(I): form-letter editor 


file contents 


file off-line 

file page-by-page 

file print 

file status by i-number 
file status 

file status 

file system format 

file system(V): file system format 
file system...check(I): 
file system 

file system 

file system 

file system 

file system 
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find(I): find 

pr( I): print 

dsw(I): delete 

mt(I): save/restore 
ar(I): archive ( combine) 
concatenate (or print ) 
change access mode of 
chown(I): change owner of 
wtmp(V): accounting 
archive(V): archive 
chmod( II): change mode of 
chown(II): change owner of 
close(II): close open 
core(V): core image 
ep(I): copy 

creat(II): create 

exec( II): execute program 
fstat(II): status of open 
link(II): link to 

| in(1I): link to 

set date modified of 
mv(I): move or rename 
od(1): octal dump of 

: open(II): open 
passwd(V): password 
read(II): read 

rm(I): remove (delete) 
sort(I): sort ascil 
sum(I): sum 

unlink( II): remove (delete) 
write(II): write 

du( I): 

find(I): 

af(I): 

tty(1): 

tell( II): 

un(I): 


ftoa(III): convert 

const( III): 

‘fptrap( III): 

atof( III): convert ascil to 


form(I): generate 

fed( I): 

nroff(I): 

roff(I): 

directory(V): directory 
File system(V): file system 
tap(vV): DECtape 


fc(I): compile 


af(1): find 


file with g 


jiven name 


file with headings 


files inter 


actively 


files on magtape 


files 


files...cat 


(I): 


fFiles...chmod(I): 


files 
files 
file 
file 
file 
file 
file 
file 
file 
file 
file 
file 
file . 
file...mdat 
file 
File 
file 
file 
file 
file 


file 


file 
file 
file 
find disk u 
find file w 
find free da 
find name o 
find read o 
find undefi 


e(II): 


sage 

ith given name 
isk space 

f terminal 

r write pointer 
ned symbols 


fFind(I): find file with given name 


floating to 
floating—po 
floating—po 
floating 


ASCII 
int constants 
int simulator 


fork(II): create new process 


form letter 
form—-letter 
format text 
format text 
format 
format 
format 
form(I): ge 


editor 
for printing 
for printing 


nerate form Letter 


Fortran program 


fptrap( III) 


: floating-point simul ator 


free disk space 


fstat(II): 
ftoa( III): 
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status of open file 
convert floating to ASCII 


exp (III): exponential function 
bj(VI): the game of black jack 
moo(VI): the game of MOO 
ttt(VI): the game of tic-—tac-—toe 
ident(V): GCOS ident cards 
gerts( III): communicate with GCos 
communicate with MH-TSS (GCcoS)...tss(I): 
form(I): generate form letter 
gerts( III): communicate with GCOS 
getc(III): get character 
accet(I): get connect—time account ing 
date(I): get date and time of day 
we(I): get (English) word count 
stat(I): get file status 
stat(II): get file status 
tm(I): get time information 
time(II): get time of year 
gtty(II): get typewriter mode 
getuid(II): get user ID 
getc(III): get character 
getty(VII): adapt to typewriter 
: getuid(II): get user ID 
find(I): find file with given name 7 
— glob(VII): argument expander 
goto(I): command transfer 
gtty(II): get typewriter mode 
pr(I): print file with headings 
ds(I): verify directory hierarchy | 7 
hog(II): set low-priority status 
login(VII): how to log onto system 
hypot( III): compute hypotenuse 
hypot( III): compute hypotenuse 
istat(I): file status by i-number 
uids(V): map names to user ID’s 7 
jaent(v): GCOS ident cards 
ident(V): GCOS ident cards 
getuid(II): get user ID 
setuid(II): set user ID . 
4£(I): conditional command 
ilgins(II): catch illegal instruction trap 
ilgins(II): catch illegal instruction trap 
core(V): core image file 
ptx(VI): permuted index 
| tm(I)2 get time information 
utmp(V): logged-in user information 
intr(II): catch or inhibit interrupts 
quit( II): catch or inhibit quits 
jnit(VII): initializer process 
| {nit(VII): initializer process 
ilgins(II): catch illegal instruction trap 
jtoa( III): convert integer to ASCII 
atoi( III): convert ASCII to integer 
dsw(I): delete files interactively 
sh(I): command interpreter 
intr(IL): catch or inhibit interru ts 
intr( II): catch or inhibit interrupts 
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bj(VI): the game of black 
kba(VII): map of TTY 37 


:(I): 


place 


form(I): generate form 


lpr (IV): 
1a( I): 
link( II): 
in(I): 


1s(I): 
nlist(III): read name 


ali(VI): 

a.out(V): assembler and 
1a(1I): link editor 
login(I): 

login(VII): how to 

log( III): 

utmp(V): 


hog(II): set 


: m6(I): 

mt( I): save/restore files on 
mtO( IV): 

mail(I): send 


tap(I): 

man(I): run off 
uids(v)s: 
ascii(VII): 
kbd( VII): 


mem( IV): core 


mesg(I): permit or deny 
tss(I): communicate with 
msh( VII): 


chmod(I): change access 
chmod( II): change 
stty(II): set 

stty(I): set typewriter 
gtty(II): get typewriter 


istat(I): file status by i—number 

itoa(III): convert integer to ASCII 
ack 

kba(VII): map of TTY 37 keyboard 

keyboard 

Kill(II): destroy process 

label 
1a( I): 
letter 

line printer 

link editor (loader) 

link to file 

link to file 

link(II): link to file 

list contents of directory 

list 

in(I): link to file 

load DEC binary paper tapes 


link editor (loader) 


loader output 


(loader ) 

log on to system 

log onto system 

logarithm base e 

logged-in user information 
log(III): logarithm base e 
login(I): log on to system 
login(VII): how to log onto system 
low-priority status 

Ipr(Iv): line printer 

ls(I): list contents of directory 
macroprocessor 

magtape 

magtape 

mail to another user 

mail(I): send mail to another user 
makdir(II): create directory 
man(I): run off manual section 


manipulate DECtape 


manual section 

map names to user ID’s 

map of ASCII | 

map of TTY 37 keyboard 

mdate(II): set date modified of file 
mem(IV): core memory 

memory 


mesg(I): permit or deny messages 
-mesg(III): print string on typewriter 

messages 

MH-TSS (GCOS) 

mini Shell 


mkdir(I): create directory 
mode of files 

mode of file 

mode of typewriter 

modes 

mode — 
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mdate(II); set date 


moo(VI): the game of 
mount (I): 


mount (II): 


mv(I): 
seek( II): 


nlist( III): read 
tty(I): find 


nm( I): print. 


? uids(V): map 
find(I): find file with given 
fork( II): create 


od( I): 


man(I): run 

opr(I): print file 
login(VII): how to log 
close(II): close 
fstat(II): status of 
open(II): 


cat(I): concatenate 
assembler and loader 
ov(I): page 


chown(I): change 
chown(II): change 

) ov(I): 

type(I): print file 
ali(VI): load DEC binary 
a@pt(VI): read DEC aAscII 
ppt(Iv): punched 


passwd(V): 
mesg( I): 
ptx(VI): 
3$(I): 
write 
write 


seek( II): move read or 
tell(II): find read or 


chash(VI): 


cal(VI): 
echo( I): 


modified of file 

moo(VI): the game of MOO 

MOO 

mount detachable file system 
mount file system 


mount(I): mount detachable file system 


mount(II): mount file system 
move or rename file 

move read or write pointer 
msh( VII): mini Shell 


mt(I): save/restore files on magtape 


mtO(IV): magtape 

mv(I): move or rename file 
m6(I); macroprocessor 

name list 

name of .terminal 

namelist 

names to user ID’s 

name 

new process 

nlist(III): read name list 
nm(I): print namelist 
nroff(I)3; format text 
octal dump of file 
od(I): octal dump of file 
off manual section 
off—line 

onto system 


for printing 


open file 


open file 


open file 


open(II): open file 

opr(I): print file off—line 
(or print) files. 
output...a.out(V): 
overlay file print 
ov(I): page overlay file 
owner of files 

owner of file 

page overlay file print 
page-by-page 

paper tapes 

paper tapes 

paper tape 

passwd(V): password file 
password file 

permit or deny messages 
permuted index 

place label 

pointer 

pointer 

ppt(Iv): punched paper tape 
prepare symbol table 

pr(I): print file with headings 
print calendar 

print command arguments 


print 


—- xvii - 


concatenate (or 
nm(I): 


eae I): 


mesg( III): - 


ptime(III): 
ipr(Iv): line 


nroff(I): format text for. 


roff(I): format text for 
ov(I): page overlay file 
bproc(VII): boot 
rele(II): release 

fork( II): create new 
init(VII): initializer 
kill(II): destroy 
wait(II): wait for 
break( II): set 

exec(II): execute 
be(VI): compile B 

ec( I): compile C 


fe(I): compile Fortran 


tmg(VI): compile tmgl 
ppt (IV): 


qsort( III): 


quit( II): catch or inhibit 
Apt( VI): 

read( II): 

nlist( III): 

seek( II): move 

tell(Izr): find 

rele(II): 

strip(I): remove symbols, 
ttyO( IV): 
umount(I): dismount 
| rmdir(I): 

rm( I): 

unlink( II): 

| strip( I): 
mv(I): move or 
salv(I): 


rew(I): 
rfO(IV): 


rkO( IV): 


print file off-line 
print file page-by-page 
print file with headings 


print) files 


print namelist 

print string on typewriter 
print time 

printer 

printing 

printing 

print — 

procedure 

processor 

process 
process 
process 
process 
program 
program 
program 
program 
program 
program 
ptime(III): print time 


break 
file 


“ptx(VI): permuted index 


punched paper tape 

pute(III): write character or word 
qsort(III): quicker sort 

quicker sort 

quit( II): catch or inhibit quits 


quits 

read DEC ASCII paper tapes 
read file 

read name list 

read or write pointer 

read or write pointer 


read(II):; read file 

release processor 

rele(II): release processor 
relocation bits | 

remote typewriter 

removable file system 

remove (delete) directory 
remove (delete) file 

remove (delete) file 

remove symbols, relocation bits 
rename file 

repair damaged file system 
rew(I): rewind DECtape 

rewind DECtape 

RF disk 

rfO(IV): RF. disk 

RK disk 

rkO(IV): RK disk 

rmdir(iI): remove (delete) directory 
rm(I): remove (delete) file 
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sqrt( III): square 
rp0O(Iv): 


man(I): 


mt(I): 
man(I): run off manual 


mail(I): 

exit( I): end command 
mdate(II): 

hog( II): 

stty(II): 

break( II): 
stime(II): 
tabs(VII): 

stty(I): 

setuid( II): 


msh(VII): mini 


fptrap(III): floating-point 
sin( III): 


sort(I): 


qsort(III): quicker 
af(I): find free disk 
dpd (I): 


sqrt( III): 


istat(I): file 

- £stat( II): 

hog( II): set low-—priority 
stat(1I): get file 
stat(II): get file 


tabs(VII): set tab 


salloc( III): 
mesg( III): print 


sum( I): 


su(I): become 
basic(VI): DEC 


chash(VI): prepare 
ab(I): 


roff(I): format text for printing 
root 

RP disk 

rpO(IV): RP disk 

run off manual section 

salloc( III): storage allocator 
salv(I): repair damaged file system 


save/restore files on magtape 


section , 

seek(II): move read or write pointer 
send mail to another user 
sequence 

set date modified of file 
set low-priority status 
set mode of typewriter 

set program break 

set system time 

set tab stops on typewriter 
set typewriter modes 

set user ID 

setuid(II): set user ID 
Shell 

sh(I): command interpreter 
simulator 

sine, cosine | 
Sin(III): sine, cosine 
Sleep(II): delay execution 
sort ASCII file 

sort(I): sort ASCII file 
sort | 

space 

Spawn data-phone daemon 
sqrt(III): square root 
square root 

stat(I): get file status 
stat(II): get file status 
status by i-number 

status of open file 


status > 


status 
status 


-stime(II): set system time 


stops on typewriter 

storage allocator 

string on typewriter 

strip(I): remove symbols, relocation bits 
stty(I): set typewriter modes 


stty(II): set mode of typewriter 


su(I): become super-user 
sum file 


sum(I): sum file 


super—user 

supplied BASIC 

switch(III): transfer depending on value 
symbol table 

symbolic debugger 
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strip(I): remove 
un(I): find undef ined 
sync(II): assure 


file system(V): file 
stime(II): set 

file 

check consistency of File 
login(I): log on to 
login(VII): how to log onto 
mount detachable file 

mount (II): mount file 
salv(I): repair damaged file 
dismount removable file 
umount( II): dismount file 
who(I): who is on the 
tabs(VII): set 

chash(VI): prepare symbol 
cref(VI): cross-reference 


load DEC binary paper 
Apt(VI): read DEC ASCII paper 
ppt( Iv): punched paper 


tty(I): find name of 
exit( II): 

. ed( I): 
nroff(I): format 
roff(I): format 
ttt(VI): the game of 
tm(I): get 

date(I): get date and 
time(II): get 

ctime( III): convert 


ptime(III): print 
stime(II): set system 
tmg(VI): compile 


switch( III): 

goto(I): command 
cemt(II): catch EMT 

catch illegal instruction 


kba(VII): map of 


stty(I): set 


symbols, relocation pits 

symbols 

synchronization | 

sync(II): assure synchronization 
system format 

system time 

system(V): file system format 
system.. .check(I): 

system 

system | 

system...mount (I): 

system 

system 

system.,.umount(I): 

system 

system 

tab stops on typewriter 

table 

table 

tabs(VII): set tab stops on typewriter 
tacct(I): connect—time account ing 
tapes...dli(VI): 

tapes 

tape 

tap(I): manipulate DECtape 
tap(V): DECtape format 

tapO(Iv): DECtape 

tell(II): find read or write pointer 
terminal | 
terminate execution 

text editor 

text for printing 

text for printing 

tic-—tac-—toe 

time information 

time of day 

time of year 

time to ASCII 

time(II): get time of year 

time 

time 

tmgl program 

tmg(VI): compile tmgl program 
tm(I): get time information 
transfer depending on value 
transfer 

traps -° 

trap...ilgins(II): 

tss(I): communicate with MH-TSS (GCOS) 
ttt(VI): the game of tic-—tac-—toe 
TTY 37 keyboard 

tty(I): find name of terminal 
tty(IV): console typewriter 
ttyO( Iv): remote typewr iter 
type(I): print file page-by-page 
typewriter modes 
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gtty(II): get 

getty(VII): adapt to 

mesg( III): print string on 
stty(II): set mode of 
tabs(VII): set tab stops on 


tty(IV): console 


ttyO( Iv): remote 


un(I): find 


du(I): find disk 

uids(V): map names to 
getuid(II): get 

setuid(II): set 

utmp(V): logged-in 

mail(I): send mail to another 
write(I): write to another 


transfer depending on 
ds( I): 
wait( II): 


| who( I): 


gerts( III): communicate 
find(1I): find file 
pr(I): print file 
tss(I): communicate 

| we(I): get (English) 
pute(III): write character or 
chdir(I): change 
chdir( II): change 
pute( III): 

write(II): 
seek(II): move read or 
tell(II): find read or 
write(I): 


time(II): get time of 
anO( IV): 


apoO( Iv): 


kbd(VII): map of TTY 


typewriter mode 

typewr iter 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter — | 

vids(V): map names to user ID’s 
umount(I): dismount removable file system 
umount(II): dismount file system 
undefined symbols 
un(I): find undefined symbols 
unlink( II): remove (delete) file 
usage 

user ID’s 

user ID 

user ID 

user information 

user 

user 
utmp(V): logged-in user information 
vyalue...switch( III): 

verify directory hierarchy 

wait for process 

wait(II): wait for process 
we(I): get (English) word count 
who is on the system 

who(I): who is on the system 


with GCOS 


with given name 
with headings 
with MH-TSS (GCOS) 


word count 


word 

working directory 
working directory 

write character or word 
write file 

write pointer 

write pointer 

write to another user 
write(I): write to another user 
write(II): write file 
wtmp(V): accounting files 
year 

801 ACU 

201 Dataphone 

37 keyboard 
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3/15/72 | : (TI) 


NAME 2s --— place a label 
SYNOPSIS 3 [ label | 
DESCR IPT ION ; does nothing. Its only function is to place a 


Tabel for the goto command. : {4s a command so 


the Shell doesn’t have to be fixed to ignore 
lines with :’S. 


FILES -_ 
SEE ALSO | goto( I) 
DIAGNOST ICS =e 
BUGS — 


OWNER dmr 


3/15/72 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOST ICS 
BUGS 


OWNER 


accT (TI) 


acct -- login account ing 
acct [ wtmp ] 


acct produces a printout giving connect time and 
total number of connects for each user who has 


logged in during the life of the current wtmp 
file. A total is also produced, If no wtmp file 


is given, /tmp/wtmp is used. 
/tmp/wtmp 
init(VII), tacct(I), login(I), wtmp(V). 


“cannot open ‘wtmp’” if argument is unr eadable. 
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NAME 
SYNOPSIS 


DESCR IPT ION 


FILES 
SEE ALSO 


DIAGNOSTICS 


AR (TI) 


ar -- archive 
ar key afile name, «-«- 


ar maintains groups of files combined into a sin- 
gle archive file, Its main use is to create and 
update library files as used by the loader, It 
can be used, though, for any similar purpose. 


key is one character from the set drtux, option- 
ally concatenated with v. afile is the archive 
file, The names are constituent files in the 
archive file. The meanings of the key characters 
are; ’ : 

d means delete the named files from the archive 
file. 


xr means replace the named files in the archive 
file. If the archive file does not exist, I will 
create it, If the named files are not in the 
archive file, they are app ended. 


t prints a table of contents of the archive file. 
If no names are given, all files in the archive 
are tabled. If names are given, only those files 
are tabled. 


u is similar to r except that only those files 
that have been modified are replaced, If no 
names are given, all files in the archive that 
have been modified will be replaced by the modi- 
fied version. 


x will extract the named files. If no names are 
given, all files in the archive are extracted. 
In neither case does x alter the archive file. 


v means verbose, Under the verbose option, ar 
gives a file-by-file description of the making of 
a new archive file from the old archive and the 
constituent files. The following abbreviations 
are used: 


copy 
app end 
delete 
replace 
extract 


Ix 1H lula lo 


/tmp/vtm? temporary 
ld( I), archive(V ) 


“pad usage , “afile --, not in archive format 4 
cannot open temp file , name —— cannot open , 


a a 
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BUGS 


OWNER 


AR (T) 


oe ee ee 

name -- phase error , name —- cannot create , 
no archive file ,,. cannot create archive file , 
name -— not found . 


Option vt should be implemented as a table with 


more information. 


There should be a way to specify the placement of 
a new file in an archive. Currently, it is 
placed at the end. 


ken, dmr 
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NAME 
SYNOPSIS 


DESCR IPT ION 


as 


as 


as 
is 


AS (TI) 


—— assembler 


[ - ] Name, «+. 


assembles the concatenation of NAME,» sees as 
based on the DEC-provided assembler PAL-11R 


[1], although it was coded locally. Therefore, 
only the differences will be recorded. 


If 


the optional first argument — is used, all 


undefined symbols in the assembly are treated as 
global. 


Character changes are: 


In 


for use 
@ % 
# $ 
; / 


as, the character "." is a logical new line; 


several operations may appear on one line if 
separated by 3; .- Several new expression opera— 
tors have been provided: 


\> right shift (logical) 

\< left shift 

* multiplication 

\/ division 
> remainder (no longer means “register ) 


! one’s complement 
a parentheses for grouping 
result has value of left, type of right 


For example location O (relocatable) can be writ-— 


ten 


~ 


of 


0 . 3 another way to denote register 2 is 
rO ., 


All of the preceding operators are binary; if a 
left operand is missing, it is taken to be 0. 
The "! operator adds its left operand to the 
one’s complement of its right operand. 


There is a conditional assembly operation code 
a@ifferent from that of PAL-11R (whose condition- 
als are not provided): 


LE 


if expression 


~endif 


the expression evaluates to non-zero, the sec-— 


tion of code between the if. ana the endif 


is 


assembled; otherwise it is ignored, if s 


may be nested. 


- 1 = 
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AS (I) 


Temporary labels like those ;ntroduced by Knuth 
[2] may be employed. A temporary label is de- 
fined as follows: 


ns 


where n is a digit 0... 9. Symbols of the form 
"nf" refer to the first label nt following the 
use of the symbol; those of the form nb refer 
to the last nm: .- The same n may be used many 
times. Labels of this form are less taxing both 
on the imagination of the programmer and on the 
symbol table space of the assembler. 

The PAL-11R opcodes " word”, ".eot and " end” 
are redundant and are omitted. 


The symbols 


rO ... Yd | | 
frO ... fro (floating-point registers) 


ish 
ash 
nor 
csw 


are predefined with appropriate values. The sym- 
bol “csw refers to the console switches. as 

is the relocation constant and is added to each 
relocatable reference. On a PDP-11 with reloca- 
tion hardware, its value is 03; on most systems 


without protection, its value is 40000(8). 


The new opcode “sys- is used to specify system 
calls. Names for system calls are predefined. 
cee section (II). 


The opcodes “nes (branch on error set) and “pec” 
(branch on error clear) are defined to test the 
error status bit set on return from system calls. 


Strings of characters may be assembl ed in a way 

more convenient than PAL-11’s  .ascii operation 

(which is, therefore, omitted). Strings are ,, 

included between the string quotes < and > : 
<here is a string> 


Escape sequences exist to enter non graphic and 


ae Oe es 
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AS (TI) 


other difficult characters. These sequences are 
also effective in single and double character 
constants introduced by single (’) and double (") 
quotes respectively. 


use for 
\n newline (012) 
\O NULL (000) 


> 
\t TAB (011) 
\a ACK (006) 
\r CR (015) 
\p ESC (033) 
WN (134) 


as provides a primitive segment ation facility. 


ee a 


There are three segments: text, data and bss. 
The text segment is ordinarily used for code, 
The data segment is provided for initialized but 
yariable data, The bss segment cannot be ini- 
tialized, but symbols may be defined to lie 
within this segment. In the future, it iS ex- 
pected that the text segment will be write- 
protected and sharable. Assembly begins in the 


text segment. The pseudo-operations 


~cext 
~aata 
~bss 


cause the assembler to switch to the text, data, 
or bss segment respectively. | Segmentation is 
useful at present for two reasons: Non- 
initialized tables and variables, if placed in 
the bss segment, occupy no space in the output 
file. Also, alternative use of the text and data 
segments provides a primitive dual location-—- 
counter feature. 


In the output file, all text-segment information 
comes first, followed by all data-segment infor- 
mation, and finally bss information. Within each 
segment, information appears in the order writ- 
ten, 


Note: since nothing explicit can be assembled 
into the bss segment, the usual appearance of 
this segment is in the following style: 


bss 
vari: ezeta 
tabi: .=et+100. 


That is, space is reserved but nothing explicit 
is placed in ph oe 
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AS (I) 


As is evident from the example, it is legal to 
assign to the location counter ".",. It is also 
permissible in segments other than bss. The 
restriction is made, however, that the value so 
assigned must be defined in the first pass and it 
must be a value associated with the same segment 


as ee 
The pseudo-op 
- comm symbol, expression 


makes symbol an undefined global symbol, and - 
places the value of the expression in the value 
field of the symbol’s definition. Thus the above 
declaration is equivalent to 


.globl symbol = 
symbol = expression symbol 


The treatment of such a symbol by the loader 
1a(1I) is as follows: If another routine in the 
same load defines the symbol to be an ordinary 
text, data, bss, or absolute symbol, that defini-- 
tion takes precedence and the symbol acts like a 
normal undefined external. If however no other 
routine defines the symbol, the loader defines it 
as an external bss-segment symbol and reserves RD 
bytes after its location, where n is the value of 
the expression in the .comm operation, Thus 
.comm x, 100° effectively declares x to be a com- 
mon region 100 bytes long. Note: all such de- 
clarations for the same symbol in various 
routines should request the same amount of space. 


The binary output of the assembler is placed on 
the file a.,out in the current directory. a,out 
also contains the symbol table from the assembly 
and relocation bits. The output of the assembler 
is executable immediately if the assembly was 
error-free and if there were no unresolved exter- 
nal references. The link editor ld may be used 
to combine several assembly outputs and resolve 
global symbols. 


The assembler does not produce a listing of the 
source program, This is not a serious drawback; 
the debugger db discussed below is sufficiently 
powerful to render a printed octal translation of 
the source unnecessary. 


on the last pages of this section is a list of 
all the assembler’s built-in symbols, In the 
case of instructions, the addressing modes are as 
follows: 
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FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


AS (TI) 
src, dst source, destination 
r general register 
fsrce,fdst floating source, destination 
fr floating register 
exp expression 


The names of certain 11/45 opcodes are aifferent 
from those in the 11/45 manual; some were changed 
to avoid conflict with EAE register names, others 
to draw analogies with existing 11/20 instruc— 
tions. 


/etc/as2 pass 2 of the assembler 


/tmp/atmi? temporary 
/emp/atm2? temporary 
/temp/atm3? tempor ary 
a,out object 


la( I), nm(TI), sh(I), un(I), Gb(I), a.out(V), 
fptrap(III), [4] PAL-11R Assembler; DEC-11-ASDP— 


p, [2] Knuth, The Art of Computer Programming, 
Vol. T5 Fundamental Algorithms. 


when an input file cannot be read, its name fol- 
lowed by a question mark is typed and assembly 
ceases. When syntactic or semantic errors OCcCUr, 
a single-character diagnostic is typed out to- 
gether with the line number and the file name in 
which it occurred. Errors in pass 1 cause Can- 
cellation of pass 2. The possible errors are: 


parentheses error 

parentheses error 

String not terminated properly 

Indirection ( * ) used illegally 

Illegal assignment tO . 

error in Address 

Branch instruction is odd or too remote 
error in Expression a 

error in local ( F of b’) type symbol 
Garbage (unknown) character 

Rnd of file inside an If 

Multiply defined symbol as label 

odd-- word quant ity assembled at odd address 
Phase error-— - different in pass 1 and 2 
Relocation error 

Undef ined symbol 

syntax error 


Xx AHI 


KaWdOZHAMMU LY: 


Symbol table overflow is not checked. 


if ". is moved backwards by an odd number of 
bytes, relocation bits are corrupted, 


amr 
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Special variables: tell 


mount 
. umount 
oe setuid 
getuid 
Register: stime 
quit 
rO intr 
r1 fstat 
r2 : cemt 
r3 mdate 
r4 stty 
r5 gtty 
sp ilgins 
pc nog 
frO 
fri Double operand: 
fr2 
fr3 | mov src,dst 
fr4 movb 7 
fr 5 cmp . 
ecmpb . 
Fae & switches: bit . 
bitb : 
csw bic 
div bicb . 
ac bis : 
mq bisb _ 
mul | add . 
sc sub 
sr 
nor Branch: 
lsh 
ash | br 
bne 
System calls: beq 
bge 
exit blt 
fork bgt 
read ble 
write bpl 
open bmi 
close bhi 
wait blos 
creat | bvec 
link bvs 
unlink bhis 
exec ; bec (= bec) 
cndir bee 
time blo 
makdir bes 
chmod bes (= bes) 
chown 
br eak 
stat 
seek 
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clr 
clrb 
com 
comb 
inc 
incb 
daec 
daecb 
neg 
negb 
adc 
adcb 
sbc 
sbcb 
ror 
rorb 
rol 
rolb 
asr 
asrb 
asl 
aslb 
jmp 
swab 
tst 
tstb 


jsr 
rts 
sys 


Flag-setting: 


clc 
clv 
clz 
cin 
sec 
sev 
sez 
sen 


cicc 
setf 
setd 
seti 
setl 
clrf 
negf 
absf 


a 


src 
src 


Miscellaneous: 
r,ast 


r 
exp 


Pees oe ee ee ee 


Single operand: 


Floating point Ops: 


tstf 
movt 
movt 
movif 
movfi 
movof 
movfo 
addf 
subf 
mulf 
Givft 
empf 
modf 


als 
alsc 
mpy 
avd 
xor 
sxt 
mark 
sob 


Specials 


~ byte 
,~even 
ae om 
endif 
~globl 
~cext 
~aata 
bss 

- comm 


fsrc,fr 
£src, fr 


11/45 operations 


src,r 
Srec,r 
src,r 
src,r 
SrC,)r 
ast 

exp 

r,exp 


ee a 


1df ) 
stf ) 
ldcif ) 
stcfi) 
ldcd€ ) 
stcfd ) 


ash) 
ashc) 
mul ) 
div) 
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NAME 
SYNOPSIS 


DESCRIPTION 


BAS (I) 


bas -- basic 


pas [ file ] 


pas is a dialect of basic 4]. If a file argu- 
ment is provided, the file is used for input 
pefore the console is read. 


bas accepts lines of the form: 


statement 
integer statement 


Int eger numbered statements (Known as internal 
statements) are stored for later execution. They 
are stored in sorted ascending order. Non- 
numbered statements are immediately executed. 

The result of an immediate expression statement 
(that does not have ‘=’ as its highest operator ) 
is printed. 


Statements have the following syntax: (expr is 
short for expression) 


expr 
The expression is executed for its side 
effects (assignment or function call) or 
for printing as described above. 


done 
Return to system level. 


for name 


o—_—_—E—! 


or name 


—r, 


expr expr statement 
expr expr 


next : 

The for statement repetitively executes a 
statement (first form) or a group of state- 
ments (second form) under control of a 
named variable. The variable takes on the 
value of the first expression, then is 
incremented by one on each loop, not to 
exceed the value of the second expression. 


goto expr 
The expression is evaluated, truncated to 
an integer and execution goes to the 
corresponding integer numbered statment. 
If executed from immediate mode, the inter- 
nal statements are compiled first. 


if expr. statement 
The statement is executed if the expression 
evaluates to non-zero. 


list [expr [expr] ] 


—~ 1 - 
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list is used to print out the stored inter- 
nal statements. If no arguments are given, 
all internal statements are printed. If 
one argument is given, only that internal 
statement is listed. If two arguments are 
given, all internal statements inclusively 
between the arguments are printed. 


print expr 
The expression is evaluated and printed. 


return expr 
The expression is evaluated and the result 
is passed back as the value of a function 
call. | 


run | 
~ The jnternal statements are compiled. The 
symbol table js re-initialized. The random 
number generator is re-set. Control is 
passed to the lowest numbered internal 
statement. 


Expressions have the following syntax: 


name 
A name is used to specify a variable, 
Names are composed of a letter (’a’ - ‘z’) 


followed by letters and digits. The first 
four characters of a name are significant. 


numb er 
A number is used to represent a4 constant 
yalue. A number is composed of digits, at 
most one decimal point (‘.’) and possibly 4a 
scale factor of the form e.digits or &= 
digits. 


( expr ) 
Parentheses are used to alter normal order. 
of evaluation. 


expr op expr 

Common functions of two arguments are ab—- 
breviated by the two arguments separated by 
an operator denoting the function. A com— 
plete list of operators is given below. 


expr ( [expr [L, expr eee 2 ae! 

Functions of an arbitrary number of argu- 
ments can be called by an’ expression fol- 
lowed by the arguments in parentheses 
separated by commas. The expression evalu-— 
ates to the line number of the entry of the 
function in the internally stored state- 
ments. This causes the internal statements 


ues Or ae 


anh 
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to be compiled. If the expression evalu- 
ates negative, 4 puiltin function is 
called, The list of builtin functions 
appears below. 


name { expr (, expr rs ae | 


Arrays are not yet implement ed. 


The following is the list of operators: 


IN 


= is the assignment operator, The left 
operand must be a name or an array element. 
The result is. the right operand. Assign- 
ment binds right to left, all other opera 


tors bind left to right. 


& (logical and) has result zero jf either 
of its arguments are Zero. It has result 
one if both its arguments are non-zero. J 
(logical or) has result zero if both of its 
arguments are Zero. It has result one if 
either of its arguments are non-zero. 


{= >) >= == 


The relational operators (< less than, <= 
less than or equal, > greater than, ?= 
greater than or equal, == equal to, <> not 
equal to) return one 4f their arguments are 
in the specified relation. They return 
zero otherwise. Relational operators at 
the same level extend as follows: a>boc is 
the same as a>b&boc. 


Add and subtract. 


Multiply and divide. 


Exponent iation. 


AY 


The following is 4 list of builtin functions: 


arg 


exp 


' log 


aArg(i) is the value of the ith actual 
parameter on the current level of function 
call. | : 


Exp(x) is the exponential function of x. 


Log(x) is the logarithm base e of X. 
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FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


BAS (I) 


sin 
Sin(x) is the sine of x (radians). 


cos 
Cos(x) is the cosine of x (radians). 


atn | 
Atn(x) is the arctangent of X. (Not imple- 
ment ed, ) 


rna | 
Rnd() is 2 uniformly distributed random 
number between zero and one. 


expr 
Expr() is the only form of program input. 


A line is read from the input and evaluated 


as an expression. The resultant value is 
returned. 


int 
Int(x) returns x truncated to an integer. 


/temp/bt m? temporary 

[1] DEC-11-AJPB-D 

Syntax errors cause the incorrect line to be 
typed with an underscore where the parse failed. 
All other Giagnostics are self explanatory. 
arrays [] are not yet implemented, In general, 
program sizes, recursion, etc are not checked, 


ana cause trouble. 


ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


CAT (T) 


cat —- concatenate and print 


cat file, ee @ 


cat reads each file in sequence ana writes it on 


the standard output stream. Thus 3 
cat file 

4s about the easiest way to print a file, Also: 
cat file! file2 2file3 

js about the easiest way to concatenate files. 


If no input file is given cat reads from the 
standard input file. 


pr( I), cp( I) | 


none; if a file cannot be found it is ignored. 


3/15/72 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


cc (T) 


ec -— c compiler 
ec [ =¢ ] sfile,.c¢ -+> ofile, «+. 


ec is the UNIX C compiler. it accepts three 
types of arguments: 


Argument S whose names end with "c. are assumed 
to be C source programs; they are compiled, and 
the object program is left on the file sfile,.o 
(i.e. the file whose name is that of the source 
with .0O substituted for .¢ ). 


other arguments (except for "_oe") are assumed to 
pe either loader flag arguments, Of c-compatible 
object programs, typically produced by an earlier 
ec run, or perhaps libraries of C-compatible 
routines. These programs, together with the 
results of any compilations specified, are loaded 
(in the order given) to produce an executable 
program with name a,out. 


Tne "_c" argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 


file.c input file 

a,out loaded output 

c.tmp temporary (deleted) 
/sys/c/ne | compiler 

/usr /lLib/crt0.o runtime startoff 
/usr/lib/libe.a puiltin functions, etc. 
/usr/lib/liba.a system library 


c reference manual (in preparation), be(VTI) 
Diagnostics are intended to be self-explanatory. 


amr 
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SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


CHDIR (I) 


ehndir -- change working directory 

endir directory 

aGirectory becomes the new working Girectory. 
Because a nea process is created to execute each 
command, chdir would be ineffective if it were 


written as a normal command. It is therefore 
recognized and executed by the Shell. 


sh( I) 


"pad directory if the girectory cannot be 
changed to. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


CHECK (TI) 


check -- file system consistency check 
check [ filesystem [ blockno, --- i 


check will examine a file system, build a bit map 
of used blocks, and compare this bit map against 
the bit map maintained on the file system, If 
the file system is not specified, a check of all 
of the normally mounted file systems is per- 
formed. Output includes the number of files on 
the file system, the number of these that are 
‘large’, the number of used blocks, and the 
number of free blocks. 


/aev/rf?, /aev/rk?, /dev/rp? 
find(t), as(I) 


Diagnostics are produced for blocks missing, 
duplicated, and bad block addresses. Diagnostics 
are also produced for block numbers passed as 
parameters. In each case, the block number, 
i—-number, and block class (i = inode, xX indirect, 
= free) is printed. 


The checking process is two pass in nature. If 
checking is done on an active file system, ©€xX- 
traneous diagnostics may occur. 


The swap space on the RF file system is not ac- 
counted for and will therefore show up as “miss— 
ing’. 


ken, dmr 
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NAME chmod -- change mode 
SYNOPSIS chmod octal file, ... 
DESCRIPTION The octal mode replaces the mode of each of the 


files. The mode is constructed from the OR of 
the following modes: 


O01 write for non-owner 
02 read for non-owner 

04 write for owner 

40 read for owner 

20 executable 

40 set-—UID 


Only the owner of a file may change its mode, 


FILES = 
SEE ALSO stat(1I), ls(T) 
DIAGNOST ICS se i 
BUGS — 


OWNER ken, amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


CHOWN (TI) 


chown -- change owner 


chown owner file, “eee 


owner becomes the new owner of the files. The 


owner may be either 4 decimal UID or a name found 
in fetc/uids. 


Only the owner of a file is allowed to change the 
owner, it is illegal to change the owner of a 
file with the set-user-ID mode. 

/etc/uids 

stat( I) 


"no?" if owner cannot be found, “file?” if file 
cannot be found. 
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NAME 
SYNOPSIS 


DESCRIPTION 
FILES 

SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


CMP (I) 


emp -- compare two files 
emp file, file, 


The two files are compared for jdentical con- 
tents. Discrepancies are noted by giving the 
offset and the aiffering words. 


Messages are given for inability to open either 
argument, premature FOF on either argument, and 
incorrect usage. 


If the two files differ in length by one byté, 
the extra byte does not enter into the compari- 
son. 


amr 
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FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


cP (I) 


cp -- COpy 
cp file, file, 


The first file is opened for reading, the second 
created mode 17. Then the first is copied into 
the second. 


cat(I), pr(T) 


Frror returns are checked at every system call, 
and appropriate diagnostics are produced. 


The second file should be created in the mode of 
the first. 


A directory convention as used in my should be 
adopted for cp. 


ken, dmr 
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DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


DATE (TI) 


date -— print and set the date 
date [ mmddhhmn ] 
If no argument is given, the current date is 
printed to the second. If an argument is given, 
the current date is set, mm is the month number; 
dd is the day number in the month; hh is the hour 
number (24 hour system); mm is the minute number. 
For example: 

date 10080045 


sets the date to oct 8, 12:45 AM. 


"oo" sf the argument is syntactically incorrect. 


amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


DB (I) 


ab -- debug 
db [ core [ namelist At Les 


Unlike many debugging packages (including DEC’s 
oDT, on which db is loosely based) db is not 
loaded as part of the core image which it is used 
to examine; instead it examines files. Typical-_ 
ly, the file will be either a core image produced 
after a fault or the binary output of the assem— 
bler. Core is the file being debugged; if omit- 
ted core is assumed. namelist js a file con 
taining a symbol table. i1f it is omitted, the 
symbol table is obtained from the file peing 
debugged, or if not there from a.out. If no 
appropriate name list file can be found, db can 
still be used but some of its symbolic facilities 
become unavailable. 


For the meaning of the optional third argument, 
see the last paragraph below. | 


The format for most db requests is an address 
followed by a one character command. 


Addresses are expressions built up as follows: 


4. A name has the yalue assigned to it when 
| the input file was assembled. It may be 
relocatable or not depending on the use of 
the name during the assembly. 


>. An octal number is an absolute quantity 
with the appropriate value. 

3. An octal number immediately followed by "y" 

js a relocatable guantity with the ap- 

propriate value. | 


4, The symbol " " indicates the current 
pointer of db. The current pointer is set 
by many db requests. 


5. Expressions separated by "+" or ~ . (blank ) 

are expressions with value equal to the sum 
of the components.. At most one of the com- 
ponents may be relocatable. 


6. Expressions separated by —" form an ex~ 
pression with value equal to the aifference 
to the components. If the right component 
is relocatable, the left component must be 
relocatable. 


7, Expressions are evaluated left to right. 


- { - 
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Names for registers are built ins 


T0..s46-(22 


These may be examined. Their values are deduced 
from the contents of the stack in a core image 
file. They are meaningless in a file that is not 
a core imagee 


If no address is given for a command , the current 
address (also specified by . ) is assumed. In 
general, . points to the last word or byte 
printed by db. 


There are db commands for examining locations 
interpreted as octal numbers, machine instruc 
tions, ASCII characters, and addresses. For 
numbers and characters, either bytes or words may 
be examined. The following commands are used to 
examine the specified file. 


/ The addressed word is printed in octal. 
\ The addressed byte is printed in octal. 


The addressed word is printed as two ASCII 
characters. 


* m?he addressed byte is printed as an ASCII 
character. 


. w?he addressed word is multiplied by 2, then 
printed in octal (used with B programs, 
whose addresses are word addresses ). 


> The addressed word is interpreted as a 
machine instruction and a symbolic form of 
the instruction, including symbolic ad- 
dresses, is printed. often, the result 
will appear exactly as it was written in 
the source prograime. 


& The addressed word is interpreted as a sym— 
bolic address and is printed as the name of 
the symbol whose value is closest to the 
addressed word, possibly followed by a 
signed offset. 


¢nl> (ie eo, the character “new line ) This 
command advances the current location 
counter ". and prints the resulting loca- 
tion in the mode last specified by one of 
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the above requests. 


This character decrements " " and prints 
the resulting location in the mode last 
selected one of the above requests. It is 
a converse to <nl>. 


¥Y Exit. 


It is illegal for the word-oriented commands to 
have odd addresses. The incrementing and decre- 
menting of . done by the <nl> and requests is 
by one or two depending on whether the last com 
mand was word or byte oriented. 


The address portion of any of the above commands 
may be followed by a comma and then by an expres~ 
sion. iIn this case that number of sequential 
words or bytes specified by the expression is 
printed. ." is advanced so that it points at 
the last thing printed. 


There are two commands to interpret the value of 
expressions. 


- When preceded by an expression, the value 
of the expression is typed in octal. When 
not preceded by an expression, the value of 

." is indicated. This command does not 
change the value of . e 


An attempt is made to print the given ex” 
pression as a symbolic address. Tf the 
expression is relocatable, that symbol is 
found whose value is nearest that of the 
expression, anda the symbol is typed, fol- 
lowed by a sign and the appropriate offset. 
If the value of the expression is absolute, 
a symbol with exactly the indicated value 
is sought and printed if found; if no 
matching symbol is discovered, the octal 
value of the expression is given. 7 


The following command may be used to patch the 
file being debugged. 


1 This command must be preceded by an expres~- 
sion. The value of the expression is 
stored at the location addressed by the 
current value Of « « The opcodes do not 
appear in the symbol table, sO the user 
must assemble them by hand. 


The following command is used after a fault has 
caused a core image File to be produced. 
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¢ causes the fault type and the contents of 
the general registers and several other 
registers to be printed both in octal and 
symbolic format. The values are as they 
were at the time of the fault. 


Db should not be used to examine special files, 
for example disks and tapes, since it reads one 
byte at a time. Use od(I) instead. 


For some purposes, it is important to know how 
addresses typed by the user correspond with loca- 
tions in the file being debugged. The mapping 
algorithm employed by db is non-trivial for two 
reasons: First, in an a.out file, there is a 
20(8) byte header which will not appear when the 
file is loaded into core for execution. There- 
fore, apparent location O should correspond with 
actual file offset 20. Second, some systems 
cause a squashed core image to be written. In 
such a core image, addresses in the stack must be 
mapped according to the degree of squashing which 
has been employed. Db obeys the following rules: 


If exactly one argument is given, and if it ap-~ 
pears to be an a.out file, the 20—-byte header is 
skipped during addressing, i.@€., 20 is added to 
all addresses typed. Asa consequence, the 
header can be examined beginning at location -20. 


If exactly one argument is given and if the file 
does not appear to be an a.out file, no mapping 
is done. 


If zero or two arguments are given, the mapping 
appropriate to a core image file is employed. 
This means that locations above the program break 
and below the stack effectively do not exist (and 
are not, in fact, recorded in the core file). 
Locations above the user’s stack pointer are 
mapped, in looking at the core file, to the place 
where they are really stored. The per-process 
data kept by the system, which is stored in the 
last 512(10) bytes of the core file, can be ad- 
dressed at apparent locations 460000-160777. 


If one wants to examine a file which has an asso- 
ciated name list, but is not a core image file, 
the last argument ". can be used (actually the 
only purpose of the last argument is to make the 
number of arguments not equal to two). This 
feature is used most frequently in examining the 
memory file /dev/mem. 
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DIAGNOSTICS 
BUGS 


OWN ER 


DB (TI) 


as(1I), core(V), a.out(v), od(T) 


“File not found” if the first argument cannot be 
read; otherwise 2 


The ““" request always decrements " " by 2, even 
in byte mode. 


amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


pe (TI) 


dc —— desk calculator 
de 


dc is an arbitrary precision integer arithmetic 
package, The overall structure of de is a stack— 
ing (reverse Polish) calculator. The following | 
constructions are recognized by the calculator: 


number 
The value of the number is pushed on the 
stack. If the number starts with a zero, it 
is taken to be octal, otherwise it is decimal. 


+o * L3 

The top two values on the stack are added (+), 
subtracted (-), multiplied (*), divided (/), 
or remaindered (%). The two entries are 
poppped off of the stack, the result is pushed 
on the stack in their place. 


The top of the stack is popped and stored into 
a register named x, where x may be any charac-— 
ter. 


The value in register x is pushed on the 
stack. The register x is not altered. 


a | 
The top value on the stack is pushed on the 
stack. Thus the top value is duplicated. 

P | 
The top value on the stack is printed in de- 
cimal. The top value remains unchanged. . 

f 
All values on the stack are popped off and 
printed in decimal. 

ke 
exits the program 

x | i 
treats the top element of the stack as a char- 
acter string and executes it as a string of dc 
commands 

d 
interprets the rest of the line as a UNIX com— 
mand. 

P 


All values on the stack are popped. 


a, 
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pe (TI) 


nk 
A scale factor of 40" is set for all subse- 
quent multiplication and Givision. 


new-line 
space 
ignored. 


An example to calculate the monthly, weekly and 
hourly rates for a $10,000/year salary. 


40000 | 

400* (now in cents) 

asa (non-destructive store) 
12/ (pennies per month ) 
1a52/ (pennies per week ) 

a10* (deci-pennies per week ) 
375/ (pennies per nour ) 

f (print all results) 

(3) 512 

(2) 19230 

(1) 83333 


(x) 2? for unrecognized character xX. 
(x) 2? for not enough elements on the stack to do 
what was asked. 


“out of space’ when the free list is exhausted. 


f is not implemented 
¥Y is not implemented 


rhm 
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af -- disk free 


af [ filesystem ] 


af prints out the number of free blocks available 


on a file system. If the file system is unspeci- 
fied, the free space on all of the normally 
mounted file systems is printed. 

/aev/rf?, /aev/rk?, /aev/rp? 


check ( I) 
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apd -- spawn data phone daemon 


/etc/dp4a 


dpd is the 201 data phone daemon. It is designed 
to submit jobs to the Honeywell 6070 computer via 
the gerts interface. 


dpa uses the directory /usr/dpd. The file lock 
in that directory is used to prevent two daemons 
from becoming active. After the daemon has suc— 
cessfully set the lock, it forks and the main 
path exits, thus spawning the daemon. /usr/dpd 
is scanned for any file beginning with G£. Each 
such file is submitted as a job. Fach line of a 
job file must begin with a key character to 
specify what to Go with the remainder of the line 


s§ directs dpd to generate a unique snumb card. 
This card is generated by incrementing the 
first word of the file /usr/dpda/snumb and con- 
verting that to decimal concatenated with the 
station ID. 


L specifies that the remainder of the line is 
to be sent as a literal, — 


B specifies that the rest of the line is a 
file name, That file is to be sent as binary 
cards, 


F is the same as B except the file is prepend- 
ed with a form feed. 


U specifies that the rest of the line is a 
file name. After the job has been transmit— 
ted, the file is unlinked. 


Any error encountered will cause the daemon to 
drop the call, wait up to 20 minutes and start 
over, This means that an improperly constructed 
af file may cause the same job to be submitted 
every 20 minutes. 


While waiting, the daemon checks to see that the 
lock file still exists. If the lock is gone, the 
daemon will exit. " 

/dev/ano, /aev/dap0, /usr /apa/* 

opr (T) 


~ 1 - 


ws 5 


3/15/72 


OWNER 


ken 


DPD (I) 


3/15/72 


NAME 
SYNOPSIS 


DESCR IPT ION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


Ds (I) 


ds -—— directory consistency check 

as [ output ] 

as will walk the directory tree from the root 
keeping a list of every file encountered. The 
second pass will read the i-list and compare the 
number of links there with the actual number 
found. All a@iscrepancies are noted, 


If an argument is given, a complete printout of 
file names by j—number is output on the argument. 


/, faev/rk0, /tmp/dastmp 

check (I) 

inconsistent j—numbers 

the root is noted as inconsistent due to the fact 


that / exists in no Girectory. (Its i-number is 
41.) 


as should take an alternate file system argument. 


ken 
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psw (T) 


adsw -- delete interactively 
dsw [ directory ] 


For each file in the given directory ars if not 
specified) asw types its name. If y is typed, 
the file is aeleted; if x , Gsw exits; if any- 
thing else, the file is not removed. 


rm( TI) 


< 


The name “dsw is a carryover from the ancient 
past. its etymology is amusing but the name is 
nonetheless {ll-advised. 


admr, ken 
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pu (TI) 


du — summarize disk usage 
du C-s] [a] (name... ] 


du gives the number of blocks contained in all 
files and (recursively) directories within each 
specified directory or file name. Tf name is 
missing, . is used. 


The optional argument -s causes only the grand 
total to be given. The optional argument —a 
causes an entry to be generated for each file. 
Absence of either causes an entry to be generated 


for each directory only. 


A file which has two links to it is only count ed 
once. 


Non-directories given as arguments (not under -a 
option) are not listed. 


Removable file systems do not work correctly 
since i-numbers may pe repeated while the 
corresponding files are Gistinct, bu should 
maintain an j—-number list per root directory 
encount er ed. 


dmr 
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ECHO (T) 


echo -- echo arguments 


echo [ ALG, oes 7 


echo writes all its arguments in order as a line 


on the standard output file. It is mainly useful 


for producing diagnostics in command files. 


~i1- 


ans, 
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ED (1) 


ed — editor 


ed [ name ] 


ed is the standard text editor. 


If the optional argument is givens ed simulates 
an e command on the named file; that is to say, 
the file is read into ea’s buffer so that it can 
be edited. 


ed operates on a copy of any file it is editing; 
changes made in the copy have no effect on the 
file until an explicit write (w) command is 
given. The Copy of the text being edited resides 
in a temporary file called the puffer. There is 
only one buffer. 


Commands to ed have 4 simple and regular 
structure: zero or more addresses followed by 2 
single character command, possibly followed by 
parameters to the command. These addresses 
specify one or more lines in the buffer. Every 
command which requires addresses has default 
addresses, so that the addresses can often be 
omitted. 


In general only one command may appear on 4 line. 
Certain commands allow the input of text. This 
text is placed in the appropriate place in the 
puffer. While a is accepting text, it is said 


aS 


to be in input mode. In this mode, no commands 
are recognized; all input is merely collected. 
Input mode is left by typing @ period (.) alone 


at the beginning of a line. 


ed supports a limitea form of regular expression 
notation. A regular expression is an expression 
which specifies a set of strings of characters. 
A member of this set of strings is said to be 
matched by the regular expression. The regular 
expressions allowed by ed are constructed as 
follows: 


\ 


4, An ordinary character (not one of those 
discussed below) is a regular expression 
and matches that character. 


2. A circumflex (~) at the beginning of a reg- 
ular expression matches the null character 
at the beginning of a line. 


3. A currency symbol ($) at the end of a regu- 


lar expression matches the null character 
at the end of a line. 


a 
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4. A period (.) matches any character but a 
new-line character. 


5. A regular expression followed by an aster-— 
isk (*) matches any number of adjacent 
occurrences (including zero) of the regular 
expression it follows. 


6. A string of characters enclosed in square 
prackets ({]) matches any character in the 
string but no others. If, however, the 
first character of the string is 4 circum— 
flex (~) the regular expression matches any 
character but new-line and the characters 
in the string. 


7. The concatenation of regular expressions is 
a regular expression which matches the con 
catenation of the strings matched by the 
components of the regular expression. 


8. The null regular expression standing alone 
is equivalent to the last regular expres— 
sion encountered. 


Regular expressions are used in addresses to 
specify lines and in one command (s, see below) 
to specify a portion of a line which is to be 


replaced. 


tf it is desired to use one of the regular ex- 
pression metacharacters as an ordinary character, 
that character may pe preceded by \". This also 
applies to the character pounding the regular 
expression (often /") and to \ itself. 


Addresses are constructed as follows. TO under- 
stand addressing in ed it is necessary to know 
that at any time there is a current line. Gen- 
erally speaking, the current line is the last 
line affected by 2 command; however, the exact 
effect on the current line by each command is 


discussed under the description of the command. 


4. The character Rhee aadresses the current 
line. 


>. The character "a" .daaresses the line im- 
mediately before the current line. 


3. The character re addresses the last line 
of the buffer. 


4. A decimal number B addresses the nth line 
of the buffer. 


-2- 
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6. A regular expression enclosed in slashes 
/" addresses the first line found by 
searching toward the ena of the buffer and 
stopping at the first line containing a 
string matching the regular expression. If 
necessary the search wraps around to the 
beginning of the puffer. 


5. A regular expression enclosed in queries 
2" addresses the first line found by 
searching toward the beginning of the 
puffer and stopping at the first line found 
containing a string matching the regular 
expression, If necessary the search wraps 
around to the end of the puffer. 


7. An address followed by a plus sign "} or a 
minus sign -— followed by a decimal number 
specifies that address plus (resp. minus ) 
the indicated number of lines. The plus 
sign may be omitted. 


8. "*s" addresses the line associated (marked ) 
with the mark name character xX which must 
be a printable character. Lines may be 
marked with the "k” command described 
below, 


Commands may require zero, ONC, or two addresses. 
Commands which require no addresses regard the 
presence of an address as an error. Commands 
which accept one or two addresses assume default 
addresses when insufficient are given. If more 


addresses are given than such a command requires, 


the last one or two (depending on what is accept-— 
ed) are used. 


Ada@resses are separated from each other typically 
by a comma (,). They may also be separated by, @,, 
semicolon (;)..In this case the current line . 
is set to the the previous address before the 
next address 1s interpreted. This feature can be 
used to determine the starting, line for forward 
and backward searches (/, ? ). The second 
address of any two-address sequence must 
correspond to a line following the line 
corresponding to the first address. 


In the following list of ed commands, the default 
addresses are shown in parentheses, The 
parentheses are not part of the address, but are. 
used to show that the given addresses are the 
default. 


As mentioned, it is generally illegal for more 
than one command to appear on a line. However, 


oa ie 
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any command may be suffixed by "pD- (for “print ). 
In that case, the current line is printed after 
the command is complete. 


(.)a 
<text> 
The append command reads the given text and 
appends it after the addressed line. era 
is left on the last line input, if there 
were any, otherwise at the addressed line. 
Address 0 is legal for this command; text 
is placed at the beginning of the buffer. 


errs 
<text> 


The change command deletes the addressed 
lines, then accepts input text which re- 
places these lines. . is left at the 
last line input; if there were none, it is 
left at the first line not changed. 


(.,-)a 3 
The delete command deletes the addressed 
lines from the buffer. The line originally 
after the last line deleted becomes the 
current line; if the lines deleted were 
originally at the end, the new last line 
becomes the current line. 


e filename 

The edit command causes the entire contents 
of the buffer to be deleted, and then the 
named file to be read in. » is set to 
the last line of the buffer. The number of 
characters read is typed. filename is 
remembered for possible use as a default 
file name in a subsequent r or w command. 


f filename 
The filename command prints the currently 
remembered file name. If filename is 
given, the currently remembered file name 
is changed to filename . 


(1,$)g/regular expression/command list 

In the global command, the first step is to 
mark every line which matches the given 
regular expression. Then for every such 
line, the given command list is executed 
with ".. initially set to that line. A 
single command or the first of multiple 
commands appears on the same line with the 
global command. All lines of a multi-line 
list except the last line must be ended 


a Ans 
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with "\". a, i, andc commands and associ- 
ated input are permitted; the . terminat— 
ing input mode may be omitted if it would 
be on the last line of the command list. 
The (global) commands, @g and v, are not 


permitted in the command list. 


(.)i 

ctext> 
This command inserts th¢ given text before 
the addressed line. ." is left at the 
last line input; if there were none, at the 
addressed line. This commana differs from 
the a command only in the placement of the 
text e 


(.)kx 
The mark command associates or marks the 
addressed line with the single character 
mark name x. The ‘en most rec&gt mark 
names are remembered. The current mark 
names may be printed with the n command. 


Creep: F 
P The list command prints the addressed lines 
in an unambiguous Waye Non-printing char- 
‘acters are oyer-struck as follows: 


. char prints 
bs : 
tab > 
ret €< 
ST x : 
SO  — 8 


All characters preceded by 4 prefix (ESC) 
character are printed over-struck with ” 
without the prefix. Long lines are folded 
with the sequence \newline. 


Raed 


(.,-)MA | 
The move command will reposition the ad— 
dressed lines after the line addressed by 
. The line originally after the last 
line moved becomes the current line; if the 
lines moved were originally at the end, the 


new last line becomes the current line. 


n | 
The marknames command will print the 
current mark names. 


ree): 
The print command prints the addressed 
lines. ." ais left at the last line print- 
ea. The p command may be placed on the 
same line after any command. 


ny Gs 
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od -—— octal dump 
od name [ origin 


od dumps 4 file in octal, eight words per line 
with the origin of the line on the left. If @7 
octal origin is given it is truncated to 0 mod 16 
and dumping starts from there, otherwise from O. 
Printing continues until an end-of-file condition 
or until halted py sending an interrupt signal. 


Since od does not seek, but reads to the desired 
starting point, od (rather than db) should be 
used. to dump special files. 


eaee 


db( I) 


-i- 


ie ee 
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The guit command causes ed to exit. No 
automatic write of a file is done. 


($)r filename 
The read command reads in the given file 
after the addressed line. If no file name 
is given, the remembered file name, if any, 
is used (see e and £ commands). The remem-— 
bered file name is not changed unless 
filename is the very first file name men- 
tioned. Address O is legal for xr and 
causes the file to be read at the beginning 
of the buffer. If the read is successful, 
the number of characters read is typed. 
. is left at the last line read in from 
the file. 


(.,.)s/regular expression/replacement/ or, 

(.,-)s/regular expression/replacement/g 
The substitute command searches each ad- 
dressed line for an occurrence of the 
specified regular expression, On each line 
in which a match is found, all matched 
strings are replaced by the replacement 
specified, if the global replacement indi- 
cator -g appears after the command. If 
the global indicator does not appear, only 
the first occurrence of the matched string 
is replaced. It is an error for the sub- 
stitution to fail on all addressed lines. 
Any character other than space or new-line 
may be used instead of "/" to delimit the 
regular expression and the replacement. 

.” is left at the last line substituted. 


The ampersand "& appearing in the replace- 
ment is replaced by the regular expression 
that was matched. The special meaning of 


& in this context may be suppressed by 
preceding it by \. 


(1,$)v/regular expression/command list 
This command is the same as the global com- 
mand except that the command list is exe- 
cuted with "3" dnitially set to every line 
except those matching the regular expres- 
sion 


(1,$)w filename 
The write command writes the addressed 
lines onto the given file. If the file 
does not exist, it is created mode 17 
(readable and writeable by everyone). The 
remembered file name is not changed unless 
“Filename” is the very first file name 


eee ae 
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mentioned, If no file name is given, the 
remembered file name, if any, is used (see 
e and £ commands). . ais unchanged. If 
the command is successful, the number of 
characters written is typed. 


($)= 
The line number of the addressed line is 
typed. ." is unchanged by this command. 


{UNIX command | as ois 
The remainder of the line after the ! is 
sent to UNIx to be interpreted as a com— 
mand. » dis unchanged. 


(.+1)<newline> | 
An address alone on a line causes that line 
to be printed. A blank line alone is 
equivalent to .+1P $5 it is useful for 
stepping through text. 


If an interrupt signal (ASCII DEL) is sent, ed 
will print a ? and return to its command level. 


If invoked with the command name ’-‘, (see init), 
ed will sign,on with the message Editing system 
and print * as the command level prompt charac— 
ter. | 


Ed has size limitations on the maximum number of 
lines that can be edited, and on the maximum 
number of characters in a line, in a global’s 
command list, and in a remembered file name. 
These limitations vary with the physical core 
size of the PDP11 computer on which ed is being 
used. The range of limiting sizes for the above 
mentioned items is; 1300 -— 4000 lines per file, 
256 —- 512 Characters per line, 63 -— 256 charac— 
ters per global command list, and 64 characters 
per file name. 


/tmp/etm? temporary oa 
/etc/msh to implement the ! command. 


eee : 
? for any error 


ken, dmr, jfo 
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EXIT( I) 


exit -—-— terminate command file 
exit 


exit performs a seeK to the end of its standard 


ae EE 


input file. Thus, if it is invoked inside a file 
of commands, upon return from exit the shell will 
discover an end-of-file and terminate. 


if(I), goto(I), sh(T) 


amr 
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FC (T) 


fc —- fortran compiler 
fe [-c ] sfile,.f .-- of ile, .-- 


fe is the UNIX Fortran compiler, It accepts 
three types of arguments: 


Arguments whose names end with " f° are assumed 
to be Fortran source programs; they are compiled, 
and the object program is left on the file 
sfile,.o (i.e. the file whose name is that of 
the source with ,.O substituted for ae cake 


Other arguments (except for “_o") are assumed to 
be either loader flags, or object programs, typi- 
cally produced by an earlier fc run, or perhaps 


-libraries of Fortran-compatible routines. These 


programs, together with the results of any compi- 
lations specified, are loaded (in the order 
given) to produce an executable program with name 
a,out. 

The "-c" argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 


The following is a list of differences between fc 
and ANSI standard Fortran (also see the BUGS 
section): 


4. Arbitrary combination of types is allowed in 


expressions. Not all combinations are expect— 
ed to be supported at runtime, All of the 
normal conversions involving integer, real, 
double precision and complex are allowed. 


2. The ‘standard’ implicit statement is recog- 
nized. 


3. The types Goubl ecomplex, logical*®1, integer*2 
and real*8 (doubl eprecision) are supported. 


4, & as the first character of a line signals a 
continuation card. 


5. ¢c as the first character of a line signals a 
comment. 


6. All keywords are recognized in lower case. 
7, The notion of “column 7° 4s not implemented. 
8, G-format input is free form-— leading blanks 


are ignored, the first blank after the start 
of the number terminates the field. 


or, a 


SO ene otc 


et 
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9, A comma in any numeric or logical input field 
terminates the field. | 


40. There is no carriage control on output, 


In I/O statements, only unit numbers 0-19 are — 
support ed. Unit number nn corresponds to file 
fortnn;” (e.g. unit 9 is file “fort09 ). For 
input, the file must exist; for output, it will 
be created, 


file.f input file 

a,out - loaded output 
f.tmp[123] temporary (deleted) 
/usr /Eort /£c [1234] compilation phases 
/usr/lib/fr0.0o runtime startoff 
/usr/lib/filib.a interpreter library 
fusr/lib/libf.a builtin functions, etc. 
/usr/lib/liba.a system library 


ANSI standard 


Compile-time diagnostics are given by number. If 
the source code is available, it is printed with 
an underline at the current character pointer. 
Errors possible are: 


1 statement too long 

2 syntax error in type statement 

3 redeclaration | 

4 missing ( in array declarator _ 

se) syntax error in dimension statement 

6 inappropriate or gratuitous array de— 
clarator 7 

7 syntax error in subscript bound 

8 illegal character 

9 common variable is a parameter or already 
in common | 

10 common syntax error 

11 subrout ine/blockdata/function not first 

. statement 

12 subroutine/function syntax error 

13 block data syntax error 

14 redeclaration in external 

15 external syntax error 

16 implicit syntax error 

17 subscript on non-—array 

18 incorrect subscript count 

19 subscript out of range 

20 subscript syntax error 

Zo equivalence inconsistency 

24 equivalence syntax error 

25 separate common blocks equiv alenced 

26 common block illegally extended by 
equivalence 

2/ common inconsistency created by 


es, De 
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equivalence 

() imbalance in expression 
expression syntax error 

illegal variable in equivalence 
non array/function used with 
subscripts/arguments 

goto syntax error 

illegal return 

continue, return, stop, call, end, Or 
pause syntax error 

assign syntax error 

if syntax error 

I/o syntax error 

do or I/O iteration error 

do end missing 

illegal statement in block data 


‘multiply defined labels 


undefined label 

dimension mismatch 

expression syntax error | 

end of statement in hollerith constant 
array too large 

8 table overflow 

unrecognized statement 


diagnostics: 


invalid log argument 

bad arg count to amod 

bad arg count to atan2 
excessive argument to cabs 
exp too large in cexp 

bad arg count to cmp1ix 
bad arg count to dim 
excessive argument to exp 
bad arg count to idim 

bad arg count to isign 
bad arg count to mod 

bad arg count to sign 
jllegal argument to sqrt 
assigned/computed goto out of range 
subscript out of range 


illegal I/O unit number 

inconsistent use of I/O unit 

cannot create output file 

cannot open input file 

FOF on input file | 

illegal character in format 

format does not begin with ( 

no conversion in format but non-empty 
list 

excessive parenthesis depth in format 
illegal format specification 

jllegal character in input field 

ena of format in hollerith specification 


ie a Be 
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999 unimplemented input conversion 


The following is a list of those features not yet 
impl ement ed: 


loading of common (a BLOCK DATA program must be 
written to allocate common). 


arithmetic statement functions 
data statements 

backspace, endfile, serene runt ime 
binary I/O 

no scale factors on input 


dmr, ken 
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fed -—— edit associative memory for form letter 


fed 


fed is used to edit a form letter associative 


memory file, form.m, which consists of named 
strings. Commands consist of single letters fol- 
lowed. by a list of string names separated by a 
single space and ending with a new line. The 
conventions of the Shell with respect to 7#° and 
->° hola for all commands but e and m where 
literal string names are expected. The commands 
ares: 


e name, eoe 


edit writes the string whose name is name 
onto a temporary file and executes the sys- 
tem editor ed. On exit from the system edi- 
tor the temporary file is copied back into 
the associative memory. Fach argument is 
operated on separately. The sequence of 
commands to add the string from ‘file’ to 


memory with name ‘newname’ is as follows: 


e newname 


O (printed by ed) 
ry file 

W 

q (get out of ed) 
q (get out of fe) 


To dump a string onto a files: 


e name 

200 (printed by ed) 
w filename | 

q (get out of ed) 
q (get out of fe) 


a [ name, ..- ] 


deletes a string and its name from the 
memory. When called with no arguments a 
operates in a verbose mode typing each 
string name and deleting only if a “y’ is 
typed. A ‘q’ response returns to command 
level. Any other response does nothing. 


m name, name. eee 
(move) changes the name of name, to name, 
and removes previous string name if one 
exists, Several pairs cf argumehts may be 


a. ae 
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n [ NaMe, ess ] 


(names) lists the string names in the 
memory. if called with the optional argu— 
ments, it just lists those requested. 


p name, eee 


prints the contents of the strings with 
names given by the arguments. 


q (quit) returns to the system. 


c{pl[i} 


checks the associative memory file for con- 
sistency. The optional arguments do the 


following: 


p causes any unaccounted for string to be 
printed 


f fixes broken memories by adding 
unaccounted—-for headers to free storage 
and removing references to released 
headers from associative memory. 


/emo/ftmo? temporary 
form.m associative memory 


form(I), eal), sh(T) 


‘>’ unknown command 

‘cannot open temp. file’-- cannot create a tem-— 
porary file for ed command 

‘name not in memory. if string ‘name’ is not in 
the associative memory and is used as an argument 
for d or Mm. 


ou a> 


rhm,lic 
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find -- find file with given name 
find name or number .e-. 
find searches the entire file system hierarchy 


and gives the path names of all files with the 
specified names or (decimal) i-numbers. 
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form -- form letter generator 
form proto arg, «e- 


form genefates a form-letter from a prototype 
letter, an associative memory, arguments and in a 
special case, the current date. 


If form is invoked with the proto argument 4 
the associative memory is searched for an entry 
with name ‘x’ and the contents filed under that 
name are used as the prototype. Tf the search 
fails, the message "Cx]:" is typed on the console 
and whatever text is typed in from the console, 
terminated by two new lines, is used as the pro- 
totype. 


e 8 0 
If the prototype argument is missing, {Vetter } 
is assumed. 


Basically, form js a copy process from the proto- 
type to the outvout file. If an element of the 
form [n] (where n is 4 digit from 1 to 9) is 
encountered, the nth argument arg, is inserted in 
its place, and that argument is then rescanned. * 
tf [oO] is encountered, the current date is in- 
serted. If the desired argument has not been 


given, a message of the form ([n]: is typed. 
The response typed in then 4s used for that argu- 


ment. 


tf an element of the form (narfe] or {name} is 
encountered, the name is looked up in the associ- 
ative memory. If it is found, the contents of 
the memory under this nama.replaces the original 
element (again rescanneda).. If the name is not 
found, a message of the form "[name]: is typed. 
The response typed in is used for that element. 
The response is entered in the memory under the 
name if the name is enclosed in []. The response 
is not entered in the memory but is remembered 
for the duration of the letter if the name is 
enclosed in {}. 


In both of the above cases, the response is typed 
in by. entering arbitrary text terminated by two 
new lines. Only the first of the two new lines 
is passed with the text. 


If one of the special characters [{]}\ is preced- 
ed by a \, it loses its special character. 


If a filE named “forma” already exists in the 


users directory, formb” is used as the output 
file and so forth to formz . : 


as, A. <a 


6/15/72 


FILES 


SEE ALSO 
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BUGS 


OWNER 


FORM (T) 


The file "form.m” is created if none exists, 
Because form.m is operated on by the disc allo- 
cater, it should only be changed by using fed, 
the form letter editor, or form. 


form.m associative memory 
form? output file (read only) 


fea(I), tyoe(I), roff(T) 


“cannot open output file” “cannot open memory 
file” when the appropriate files cannot be locat— 
ed or created. 


An unbalanced ] or } acts as an end of file but 
may add a few strange entries to the associative 
memory. 


rhm,ilic 


ee 
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BUGS 


OWN ER 


GoTo (TI) 


goto -- command transfer 
goto label 


goto is only allowed when the Shell is taking 
commands from a file, The file is searched, (from 
the peginning) for a line beginning with 3: fol- 
lowed by one of more spaces followed by the 
label. If such 2 line is found, the goto command 
returns. Since the read pointer in the command 
file points to the line after the label, the 
effect is to cause the Shell to transfer to the 
labelled line. 


"." is a do—-nothing command that only serves to 
place a label. 


stay, BCD). 


“goto error if the input file is 4 typewriter; 
label not found . 


amr 


-i- 


art te, 
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SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


IF (1) 


if -—- conditional command 


if expr command [ arg, ««- ] 


if evaluates the expression expr, and if its 


~alue is true, executes the given command with 


the given arguments. 


The following primitives are used to construct 
the expr: 
-r file : 

true if the file exists and is readable. 


-w file 
true if the file exists and is writable 


true if the file either exists and is 
writable, or does not exist and is 


creatable. 
s1 = s2 
true if the strings si and sz are equal. 
si j= s2 
true if the strings si-and sz are not 
equal. , 


These primaries may be combined with the follow— 
ing operators: 


! 
unary negation operator 


binary and operator 


Re 


binary or operator 


{ expr } 
parent heses for grouping. 


-a has higher precedence than -o. Notice that 
all the operators and flags are separate argu-— 
ments to if and hence must be surrounded by 


spaces. 


sh( I) 


"af error, if the expression has the wrong 
synt ax}; command not found. 


- 1 - 


IF (I) 


3/15/72 

BUGS “oe” always indicates the file is creatable, even 
if it isn’t. 

OWNER dmr 
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FILES 
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BUGS 


OWNER 


IstatT (1) 


{stat -- get inode status 


jstat {numb er, ae 


jstat gives information about one or more j—nodes 


istc-= 
on the file system [dev/rk0 « 


The information is basically in the same for as 
that for stat(I). Alt s;nformation is self- 
explanatory except the mode. The mode is a 

sev en-char act er string whose characters mean the 
following: 


4 a: i-node is allocated 

u: i-node is free (no file) 

2 s: file is emall (smaller than 4096 bytes) 
1: file is large 


3 a: file is 4 airectory 
- file is executable 
uz set user ID on execution 
—-: none of the above 


4r: owner can read 
—-: owner cannot read 


Sw: owner ean write 
-- owner cannot write 


- non-owner can read 
—s$ non-owner cannot read 


J ws: non-owner can write 
=-% non-owner cannot write 


The owner is almost always given in symbolic 
form; however if ne cannot be found in 

fetc/uids 4 number is given. 

If the number of arguments to stat is not exactly 
4 a neader is generated jaent ifying the fields of 
the status information. 

fetc/uids, /aev/rk0 

stat( I) is(1r) (-1 option ) 


bl eo 
name? for any error. 


jstat should take an optional alternate filesy>— 
tem argument. 


dmr 


-i- 
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NAME 


SYNOPSIS 


DESCRIPTION 


LD (TI) 


1a4 -- link editor 
ia [{ -usaol J name, +>: 


id combines several ob ject programs into one; 
resolves external references; and searches li- 
praries. In the simplest case the names of 
several object programs are given, and 1d com— 
bines then, producing an object module which can 
be either executed or become the input for a 
further ld run. In the latter case, the om ol 
option must be given to preserve the relocation 
pits. 


The argument routines are concatenated in the 
order specified. The entry point of the output 
is the beginning of the first routine. 


If any argument js a library, it is searched 
exactly once. Only those routines defining an 
unr esolved external reference are loaded. If a 
routine from 4 library references another routine 
in the library; the referenced routine must ap— 
pear after the referencing routine in the li- 
prary. Thus the order of libraries is important. 


id understands several flag arguments which are 
written pr eceded by a - 


_s "squash the output, that is, remove the 
symbol table and relocation bits to save 
space (but impair the usefulness of the 
debugger). This information can also be 
removed by strip. 


-u take the following argument as a symbol and 
enter it as undefined in the symbol table. 
This is useful for loading wholly from a 
library, since initially the symbol table 
is empty and an unresolved reference is 
needed to force the loading of the first 
routine. 


_1 This option is an abbreviation for 4 li- 
brary name. —~1 alone stands for 
*“/usr/lib/liba.a , which is the standard 
system library for assembly language pro-,, 
grams. * ix” stands for /usr /1lib/libx.a 
where x is any character. There are li- 
praries for Fortran (x= £ ), C (x= c )y 
Explor (x= ée ) and B (x= b , 


-x Do not preserve local (non-.globl ) symbols 
in the output symbol table; only enter 
external symbols. This option saves some 
space in the output file. 


-~1- 


4 
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DIAGNOSTICS 


OWNER 


LD (TI) 


-r generate relocation bits in the output file 

so that it can be the subject of another ld 
run. 

The output of id is left on a,out. This file is 

executable only if no errors occurred during the 

load. 


/usr/1ib/1ib? .a Libraries 
a,out output file 


as(I), ar (I) 
"eile not found”-- bad argument 


“vad format”-- bad argument 


“relocation error -- pad argument (relocation 
bits corrupted) 


“mult iply defined -- same symbol defined twice in 
same load 


“oan —- stands for “undefined symbol” 
“symbol not found -- loader bug 


8 e ve e 
can t move output file -- can’t move temporary 


to a,out file 


no relocation bits -- and input file lacks relo- 
cation information 


“too many symbols’ -- too many references to 
external symbols in a given routine 


"premature EOF” 
“can’t create L.out"-- cannot make temporary file 


“multiple entry point’ —- more than one entry 
point specified (not possible yet). 


Instructions in the data segment are not relocat— 
ed properly. 


dmr 


a a 


* 


& 
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a 
name, is given, the link has that name; otherwise 


‘ LN (1) 
In -- make a Link eo . 
in name, [ name, J 
in creates a link to an existing file ‘nam LE 


4t if placed in the current directory and its 
name is the last component of name, - 


Tt is forbidden to link to a directory or to link 
across file systems. 


ur oa 


rm(T) 


2 


There is nothing particularly wrong with ln, but 
links don’t work right with respect to the backup 
system: one copy is packed up for each link, and 
(more serious) in case of 4 file system reload 
both copies are restored and the information that 
a link was involved is lost. 


ken, amr 
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FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


LOGIN (TI) 


login -- sign onto UN IX 
login [ username [ password 1] 


The login commana is used when a user initially 
signs onto UNIX, or it may be used at any time to 
change from one user to another. The latter case 
is the one summarized above and described here. 
See login (VII) for how to dial up initially. 


If login is invoked without an argument, it will 
ask for a user name, and, if appropriate, 4 pass— 
word, Echoing is turned off (if possible) aur ing 
the typing of the password, SO it will not appear 
on the written record of the session. 


After a successful login, accounting files are 
updated and the user is informed of the existence 
of mailbox and message-of -the-day files. 


Login is recognized by the Shell and executed 
directly (without forking). 


/temp/utmp account ing 
/emp/wtmp account ing 
mailbox mail 

/etc/motd messag e-of-the-day 


login(VII), jnit(VII), getty(VII), mail(T) 
“login. incorrect, if the name or the password is 
bad. No Shell, ,; cannot open password file, 


"10 directory: consult a UNIX programming coun-— 
cilor. 


amr, ken 


- 1 - 
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OWN ER 


| lr ae 
nm In 


& 


LS (TI) 


_— list contents of directory 
[ -ltasd ] name, --- 


lists the contents of one or more directories 


nder control of several options: 


1 list in long format, giving i-number, mode, 
owner, size in bytes, and time of last 
modification for each file. (see stat for 
format of the mode) 


t sort by time modified (latest first) instead 
of by name, as is normal | 


a list all entries; usually those beginning 
with . are suppressed 


Ss give size in blocks for each entry 
4g if argument is a directory, list only its 


name, not its contents (mostly used with 
-1" to get status on directory) 


If no argument is given, " “ads listed. If an 
argument is not 2 directory, its name is given. 


Jetc/uids to get user m’s for ls -#¥ 


stat( I) | see 


: : et ee ee ae 
"name nonexistent ; name unreadable 3; name 
unstatabl e. 


ques a> 


amr, ken 
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OWNER 


MAIL (T) 


mail -- send mail to another user 


mail [ letter person ««- ] 


mail without an argument searches for 4 five 
called mailbox, prints it if present, and asks if 
jt should be saved. If the answer is Y , the 
mail is renamed mbox, otherwise it is deleted. 
The answer to the above question may be supplied 


in the letter argument. 


when followed by the names of a letter and one of 
more people, the letter is appended to each 
person’s mailbox. Each letter is preceded by the 
sender’s name and a postmark. 


A person is either the name of an entry in the 
directory /USI; in which case the mail is sent to 
/usr/person/mailbox, or the path name of a airec- 
tory, in which case mailbox in that directory is 
used. 


when a user logs in he is informed of the pres— 
ence of mail. 


Jetc/uids to map uids 
mailbox input mail 

mbox saved mail 

login(T) 


“who are you?” if the user cannot be identifed,, 
for some reason (a bug). Cannot send to user 
if mailbox cannot be opened. | 


ken 
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MAN (TI) 


man —- run off section of UNIX manual 
man title [ section ] 
man is a shell command file that will locate and 
run off a particular section of this manual. 
Title is the the desired part of the manual. 
Section is the section number of the manual. (in 
Arabic, not Roman numerals.) If section is miss— 
ing, 1 is assumed, For example, 

man man 
would reproduce this page 
/sys/man/man? /* 
sh(I), roff (TI) 


"pile not found , “Usage oe 


ken 
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OWN ER 


MESG (T) 


mesg -- permit or deny messages 


mesg [n ][y ] 


mesg n forbids messages via write by revoking 
non-user write permission on the user’s typewrit- 
er, mesq y reinstates permission. mesd with no 
argument reverses the current permission. In all 


cases the previous state js reported. 
/aev/tty? 
write(T) 


"o" s£ the standard input file is not a typewrit- 
er 


- 1-— 
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NAME mkdir -- make a airectory 

SYNOPSIS mkdir dirname .-«- 

DESCRIPTION mkdir aveates specified directories in mode 17. 
The standard entries "" ang ",.. are made au- 

| tomatically. 

FILES -- | 

SEE ALSO rmdir (TI) 

DIAGNOST ICS “dirname ?” 

BUGS | -- 


OWN ER ken, dmr 
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BUGS 
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MOUNT (T) 


mount -- mount file system 


fetc/mount special dir 


mount announces to the system that a removable 


file system has been mounted on the device 
corresponding to special file special. Directory 
air (which must exist already) becomes the name 
of the root of the newly mounted file system. 


umount (I) 


oe 6 


? , if the special file is already in use, can— 
not be read, or if dir does not exist. 


Should be usable only by the super—user. 


It is possilbe to mount the same file system pack 


twice, This is a very efficient way to destroy 4 
pack. | 


ken, dmr 


- 1 = 
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NAME 
SYNOPSIS 


DESCRIPTION 


MT (I) 


mt -- manipulate magtape 


mt [ key ] [ name ... ] 


mt saves and restores selected portions of the 
file system hierarchy on magtape. Its actions 
are controlled by the key argument. The key is 24 
string of characters containing at most one func-— 
tion letter and possibly one or more function 


file or directory names specifying which files 
are to be dumped, restored, or tabled. 


The function portion of the key is specified by 
one of the following letters: 


r The indicated files and directories, to- 
gether with all subdirectories, are dumped 
onto the tape. The old contents of the 
tape are lost. 


x extracts the named files from the tape to 
the file system. The owner, mode, and 
date-modified are restored to what they 
were when the file was dumped. If no file 
argument is given, the entire contents of 
the tape are extracted. 


t lists the names of all files stored on the 
tape which are the same as or are hierarch-— 
jcally below the file arguments. Tf no 
file argument is given, the entire contents 
of the tape are tabled. 


1 is the same as t except that an expanded 
listing is produced giving all the avail- 
able information about the listed files. 


The following characters may be used in addition 
to the letter which selects the function desired. 


Oy. oatea 7 This modifier select§ the arive on 

which the tape is mount ed. Oo is the 
default. 

y Normally mt does its work silently. The wv 
(verbose) option causes it to type the name 
of each file it treats preceded by 2 letter 
to indicate what is nappening. 


a file is being add ed 
x file is being extracted 


The vy option can be used with r and x only. 
f causes new entries copied on tape to be 


-~ 1- 
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OWNER 


MT (TI) 


‘fake’ in that only the entries, not the 


data associated with the entries are updat-— 
ed. Such fake entries cannot be extracted. 


Usable only with r. 


w causes mt to pause before treating each 
file, type the indicative letter and the 
file name (as with v) and await the user’s 


response. Response y means yes , so the 


file is treated. Null response means no 


and the file does not take part in whateyer 


is being done. Response x means exit 
the mt command terminates immediately. 
the x function, files previously asked 


about have been extracted already. With Ir, 


no change has been made to the tape. 


m make (create) directories during an x if 
necessary. | 


i ignore tape errors. It is suggested that 
this option be used with caution to read 
damaged tapes. 


/aev/mt? 
tap(I), tap(Vv) 


Tape open error 

Tape read error 

Tape write error 

Directory checksum 

Directory overflow 

Tape overflow 

Phase error (a file has changed after it was 
selected for dumping but before it was dumped ) 


The m option does not work correctly. The i 
option is not yet implement ed, 


ken 
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mv (I) 


mv —-- move or rename a file 


am ame 
mv n e, n 2 


my changes the name of name, by linking to it 
under the name name and then unlinking name, « 

If the new name is 3 directory, the file is moved 
to that directory under its old name. Direc— 
tories may only pe moved within the same parent 
directory (just renamed). 


Since mv is implement ed by combinations of link 
and unlink, it cannot be used to move between 
file systems. 


ken, Gmr 
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FILES 


m6 (T) 


m6 —- general purvose macro processor 


m6 [ -d argi } [ arg2 [ arg3 | | 


m6 takes input from file arg2 (or standard input 
if arg2 is missing) and places output on file 
arg3 (or standard output). a working file of 
aefinitions, m,adef , is initialized from file 
argi if that is supplied. M6 aiffers from the 
stanaara [1] in these respects: 


#trace:, #source: and #end: are not aefined. 


#meta,arg1,arg2: transfers the role of metachar— 
acter arg1 to character arg2. If two metacharac— 
ters become identical thereby, the outcome of 
further processing is not guaranteed. For exam— 
ple, to make (1 {} play the roles of #:<> type 


\#meta,<\#>,L? 
[meta,<:>,]: 

fmeta, [substr,<<>>415154 1) 
[meta, [substr, {{>>.2113 


#del,argi: deletes the definition of macro argi. 


#save: and #rest: save and restore the definition 
table together with the current metacharacters On 
file m.def. 


gadef,arg1,arg2,arg3? works as in the standard 
with the extension that an integer may be sup- 
plied to arg3 to cause the new macro to perform 
the action of a specified builtin before its 
replacement cext is evaluated. Thus all bultins 
except #def: can be retrieved even after dele- 
tion. Codes for arg3 are: 


O - no function 
445243945998 - gt,eq,ge,it,ne,le 


7,8 - seq,sne 

9,10,11,12,13 - adda, sub,mpy,div, &xP 
20 - if 

21522: = daef,copy 

23 -— meta 

24 -— size 


25 - substr 

26,2/ - go,gobk 
28 - del 

29 - dnl 

30,31 - save,rest 


m, def—--working file of definitions 
/sys/lang/mair/m6a——me processor proper (/pbin/m6é 


/sys/lang/mdir/méb-—default {nitialization for 


a 
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m6 (TI) 


m.def 
(1] m6 reference 


“err —-—- a bug, 4n unknown builtin or 4 bad de- 
finition table 


oe 


"oprd”--can't open input or initial definitions 


"“opwr --can't open output Ove —-— overflow of 
nested calls 

ova, oo overflow of nested arguments 

ov", _. overflow of definitions 

Be oo) can’t read definition table 

wra” -- can’t write definition table, either on 


#save: or on garbage collection 


Characters in internal tables are stored one per 
word. They really should be packed to improve 
capacity. For want of space (and pecause of 
unpacked formats) no file arguments have been 
provided to #save: or #rest: Again to save space, 
garbage collection makes calls on #save: and 
#rest: and so overwrites m,def. 


doug 
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NM (TI) 


nm — print name list 
[ name ] 


prints the symbol table from the output file 
an assembler Or loader run. Fach symbol name 
preceded by its value (blanks if undefined) 
and one of the letters U (undef ined) "a" (abso- 
lute) "3" (text segment symbol ), pD” (data seg- 
ment symbol), or 8 (bss segment symbol). Gilo- 


pal symbols have their first character under-—- 
lined, The output is sorted alphabetically. 


nm 
nm 
of 
is 


tf no file is given, the symbols in a,out are 


listed. 


a,out 


as(I), 1a(T) 


-~-i1i- 
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oD (I) 


——- octal dump 
name [ origin 1 


dumps a file in octal, eight words per line 
th the origin of the line on the left. If @™& 
octal origin is given it 4s truncated to O mod 16 
ana dumping starts from there, otherwise from OZ 
Printing continues until an end-of -file condition 
or until halted by sending an interrupt signal. 


z\2 12 3 


Since od does not seek, but reads to the desired 


roel 


starting point, od (rather than ab) should be 
used to dump special files. 


qa» 


db( I) 
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OPR (T) 


opr —- off line print 
Opr file, oe8 


opr will arrange to have the 201 data phone dae- 
mon submit a job to the Honeywell 6070 to print 
the file arguments. Normally, each file is 
printed in the state it is found when the data 
phone daemon reads it. If 2 particular file 
argument is preceded by + then opr will make a 
copy for the daemon to print. If the file argu- 
ment is preceded by = then opr will unlink the 
file. 


/usr /apa/* spool area 
Jetc/ident personal ident cards 
/etc/dpda daemon 


dpa(I), ident(V) 


=e 


Since all but the + option in Opt is implement ed 
with links, one cannot use these options for 
files not in /usr. 


opr should recognize + and = alone and apply them 
to all subsequent arguments. 


ken 
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ov(T) 


ov -- overlay pages 
ov filename 


ov is a postprocessor for producing double column 


Formatted text when using nroff(I). vy assumes 


cael 


that the named file contains an even number of 66 
line pages and literally overlays successive 
pairs of pages. 

none 

nroff (I) 

none 


Other page lengths should be permitted. 


jfo 


-~ 1 = 
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DIAGNOSTICS 
BUGS 
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PR (I) 


pr -- print file 
pr [ -lem | Name, ees 


pr produces 4 printed listing of one or more 
files, The output js separated into pages neaded 
by the name of the file, a date, and the page 
number. 


The optional fl _1 causes each page to contain 


euawems 


78 lines instead of the standard 66 to accommo- 
agate legal size papers 


The optional flags —¢ (current date) and —m 


ones ED 


(modified aate) specify which date will head all 
subsequent files. <= is default. 


Interconsole messages via write(I) are forbidden 
Guring a pr. 


/aev/tty? to suspend messages. 
cat(I), cp(l), mesg( TI) 

_. (files not found are ignored) 
none 


ken, Gmr 
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REwW (TI) 


rew —-— rewind tape 


H 


ew [ digit ] 


rew rewinds DECtape drives. The digit is the 
logical tape number, and should range from O to 
7. Amissing digit indicates drive 0. 


/aev/tap? 


"oo" af there is no tape mounted on the indicated 
drive or if the file cannot be opened. 


3/15/72 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


RM (T) 


rm -—— remove (unlink) files 


rm name, eee 


rm removes the entries for one or more files from 
a directory. If an entry was the last link to 
the file, the file is destroyed. Removal of a 
file requires write permission in its directory, 
put neither read nor write permission on the file 


{tself. 


Directories cannot be removed by rm; cf, rmdir. 


none 
rmdir(T) 


If the file cannot be removed or does not exist, 
the name of the file followed by a question mark 
is typed. 


rm probably should ask whether a read-only file 
is really to be removed. 


ken, amr 
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DIAGNOSTICS 


BUGS 


OWNER 


RMDIR (T) 


rmdir -- remove directory 
rmdir dir, ee. 


rmdir removes (deletes) directories. The direc- 
tory must be empty (except for the standard en- 
tries ".. and ".. , which rmdir itself removes). 
Write permission is required in the Girectory in 
which the directory appears. 


none 


“air?” is printed if directory dir cannot be 
found, is not 4 directory, or is not removable, 


“Gir --— directory not empty” is printed if dir 
has entries other than . OF ee s« 
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OWNER 


ROFF (I) 


roff -- format text 
roff [ +number1 } [ =number2 ] { -stop ] name, ee. 


roff formats text according to control lines 
embedded in the text in files name,, «ee » 
Fncountering 2 nonexistent file terminates print— 
ing. The optional argument +number1 causes 
printing to begin at the first page number ed 
number1; the optional argument -number2 stops 
printing after the page numbered numbered . The 
optional argument -—Stop or -s. causes printing 
to stop before each page including the first to 
allow paper manipulation; printing is resumed 
upon receipt of an interrupt signal. An int er—- 
rupt signal received during printing terminates 
all printing. Incoming interconsole messages are 
turned off during printing, and the original mes— 
sage acceptance state is restored upon termina-—- 
tion. 


roff is described in a separate publication ae 


jetc/suft ab suffix hyphenation tables 
/tmp/rtm? temporary 


[1] (See J. F. Ossanna) 
none 


jf£o 
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NAME salv -- file system salvage 
SYNOPSIS /etc/saly 
DFSCRIPT ION salv will reconstruct the file system /aev/rk0 to 


a consistent state. This is the first step in 
putting things together after a bad crash. Salv 
performs the following functions: 


A valid free list is constructed. 


All bad pointers in the file system are 
zeroed. 


All duplicate pointers to the same block are 
resolved by changing one of the pointers to 
point at a new block containing 4 copy of the 
data. 


after a salv, a warm boot must be performed _in- 
stantly to effect the change made. (Because the 
salv works on the disk copy of the file system 
super-block, and the core copy is unaffected. ) 


after a salv, files may be safely created and 

removed without causing more trouble. However, 
4t is more likely than not that directories are 
corrupted as well, so a ds should be performed. 


FILES /aev/rk0 

SEE ALSO | check(I), as(TI) 

DIAGNOSTICS -— | 

BUGS Bama system to be salvaged should be an argu- 
ment. 


OWN ER ken 
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SH (TI) 


sh —- shell ( command interpreter ) 
sh [ name [ arg, oes [ arg, ] a 


sh is the standard command interpreter. It is 
the program which reads and arranges the execu 
tion of the command lines typed by most users, 

It may itself be called as 4 command to interpret 
files of commands. pefore discussing the argu- 
ments to the shell used as 4 command, the struc— 
ture of command lines themselves will be given. 


Command lines 


quests 


Command lines are sequences of commands separated 
by command delimiters. Fach command is a2 Se— 
quence of non—bl ank command arguments separated 
by blanks. The first argument specifies the name 
of a command to be executed. Except for certain 
types of special argument s discussed below, the 
arguments other than the command name are simply 
passed to the ;nvoked command. 


If the first argument is the name of an execut— 
able file, jt is invoked; otherwise the string 

/pin/ is prepended to the argument. (In this 
way the standard commands, which reside in 

/pin , are found.) If the /bin. file exists, 
put is not executable, it is used by the shell as 
a command file. That is to say it is executed as 
{input as though it were typed from the console. 
If all attempts fail, 4 diagnostic is printed. 


The remaining non—-special arguments are simply 
passed to the command without further interpr eta— 
tion by the shell. 


Command delimiters 


Peta 


There are thr ee command delimiters: the new— 
line, 3 » and & . The semicolon ; specifies 
sequent ial execution of the commands So 
separated; that is, 


coma; comb 


causes the execution first of command coma, then 
of comb, The ampersand & causes simultaneous 
execution: 


coma & comb 


causes coma to be called, followed immediately by 
comb without waiting for coma to finish. Thus 
coma and comb execute simultaneously. As a spe- 
cial case, 


oe 
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coma & 


causes coma to be executed and the shell immedi- 
ately to request another command without waiting 
for coma, 


Termination Reporting 


If a command (not followed by ee) termin ates 
abnormally, a message is printed, (Al1 termin a— 
tions other than exit and interrupt are con- 
sidered abnormal.) The following is a list of the 
abnormal termination messages: 


Bus error 

Trace trap 

Illegal instruction 
ToT trap 

Power fail trap 

EMT trap 

Bad system call 
Quit 

Error 


If a core image is produced, teres COL C dumped” is 
appended to the appropriate message. 


Redirection of 1/0 


Three character sequences cause the immediately 
following string to be interpreted as a special 
argument to the shell itself, not passed to the 
command. .- 


an argument of the form “arg. causes the file 
arg to be used as the standard input file of the 
given command. 


an argument of the form “Sarg” causes file “arg” 
to be used as the standard output file for the 
given command. .Arg is created if it did not 
exist, and in any case is truncated at the 
outset. 


An argument of the form "S>arg. causes file "arg. 
to be used as the standard output for the given 
command, If arg dia not exist, it is created; 
4f it did exist, the command output is appended 
to the file. 


Generation of argument lists 


Tf any argument contains any of the characters 
"ou Se" or “[*, it is treated specially as fol- 
lows. The current directory is searched for 
files which match the given argument. 


a: De 
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The character “#™ ain an argument matches any 
string of characters in a file name (including 
the null string). 


The character "o" matches any single character in 
a file name. 


rach "(" must be paired with 3 matching "J. The 
characters between ana "]" specify a class of 
characters. It matches any single character in a 
file name which is in the class. An ordinary 
character in the prackets specifies that charac-— 
ter to be in the class. A pair of characters 
separated by — specifies each character lexi- 
cally greater than or equal to the first and less 
than or equal to the second member of the pair is 
to be included in the class. If the first member 
of the pair lexically exceeds the second, the 
second member is the sole character specified. 


Other characters match only the same character in 
the file name. | 

For example, "x" matches all file names}; o 
matches all one-character file names; |, [ab]*.s" 
matches all file names, beginning with a or 

and ending with .S 3 e[zi-m] matches all two- 
character file names ending with z or the 
letters i through mM . 


ee 


If the argument with "*" or "o" also contains 4 

a ae slightly aifferent procedure is used: 
instead of the current directory, the directory 
used is the one obtained by taking the argument 
up to the last /" pefore a or ? « The 
matching process matches the remainder of the 
argument after this /" against the files in the 
gerived directory. For example: /usr/amr/a* .s 
matches all files in directoly " /usr /dmr which 
begin with 4 and end with .-§ >» 


In any event, 4 list of names is obtained which 
match the argument. This list is sorted into 
alphabetical order, and the resulting sequence of 
arguments replaces the single argument containing 
the ae [ , or "o". The same process is car-— 
ried out for each argument (the resulting lists 
are not merged) and finally the command is called 
with the resulting list of arguments. 


For example: directory /usr/amr contains the 
Files a1.S, a2.5, ee» a9.s. From any airectory, 
the command 


as /usr/dmr/a?.s 
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calls as with arguments /usr/dmr/ai.s, 
/usr/damr/a2.S, ees /usr/amr/a9,.s in that order. 


Quoting 


The character "\" causes the immediately follow-— 
ing character to lose any special meaning it may 
have to the shell; in this way "Cg, ie sand 
other characters meaningful to the shell may be 
passed as part of arguments. A special case of 
this feature allows the continuation of commands 
onto more than one line: 4a new-line preceded by 


"\" ais translated into a blank. 


Sequences of characters enclosed in double (") or 
single (’) quotes are also taken literally. 


Argument passing 


when the shell is invoked as a command, it has 
additional string processing capabilities. Re- 
call that the form in which the shell is invoked 
is 


sh [ name [ arg, --- [ AIG 1 3 


The name is the name of a file which will be read 
and interpreted, If not given, this subinstance 
of the shell will continue to read the standard 
input file. 


In the file, character sequences of the form 

$n , where nis a Gigit 0, see, 9%, are replaced 
by the nth argument to the invocation of the 
shell (arg, ). $0" is replaced by name. 


rnd of file 

An end-of -file in the shell’s input causes it to 
exit. aA side effect of this fact means that the 
way to log out from UNIX is to type an end of 
file, 

Special commands 

Two commands are treated specially by the shell. 


“chair” is done without spawning a new process by 
executing the sys chdir primitive. 7 


“Login. is Gone by executing /bin/login without 
creating a néw process. 


These peculiarities are inexorably imposed upon 
the shell by the basic structure of the UNIX pro- 
cess control system, It is a rewarding exercise 


a 
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to work out why. 


Command file errors 


Any shell-detected error in a file of commands 
causes that shell to cease executing that file. 


/etc/glob, which interprets "e™ "2" and “[". 


“rhe UNIX Time-sharing System”, which gives the 
theory of operation of the shell. 


“Input not found , when a command file is speci- 
fied which, cannot be read; 

Arg count , if the number of arguments to the 
chdir pseudo-command is not exactly 1, or if “*", 
2", or [ is used inappropriately; 

Bad directory , if the directory given in 
chdir cannot be switched to; 
Try again , if no new process can be created to 
execute the specified command 3 

’ gmbalance , if single or double quotes are 
not matched 3 ae 

Input file , if an argument after < cannot be 

Output file , if an argument after > or >> 
cannot be written (or created); 

No command , if the specified command cannot be 
execut ed. ,, 

No match , if no arguments are generated for a 
command which contains * , 2 4 OF 3 
Termination messages described above. 


If any argument contains a quoted "*", Og JOT 
[", then all instances of these characters must 
be quoted, This is because sh calis the glob 
routine whenever an unquoted * . 2", or [ is 
noticed; the fact that other instances of these 
Characters occurred quoted is not noticed by 


glob. 


admr, ken 
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SORT (TI) 


sort —- sort a file 


sort input output 


sort will sort the input file and write the sort-— 
ed file on the output file. The sort is line- 
by-line in increasing ASCI1l collating sequence. 


. Space required is 6*number—of —lines in bytes. 


/tmp/stm? 


aoa ow 


Sort does not put a maximum on the size of file 
that it sorts. -Phus a bus error will occur if 
too large an input file is supplied. 


The input is copied to 4 temporary file, Thus 
the maximum file that can be sorted is the max- 
imum non-special file (currently 64K bytes. ) 


dmr, ken 


a 
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NAME stat -- get file status 
SYNOPSIS stat name, .-- | 
DESCRIPTION stat gives several kinds of information about one 


or more files: 


{—numb er 

access mode 

number of links 

owner 

size in bytes 

date and time of last modification 

name (useful when several files are named) 


All information is self-explanatory except the 
mode. The mode is 4 six—character string whose 
characters mean the following: 


file is small (smaller than 4096 bytes) 
file is large 


4 


bt 1 
oe ee 


file is a directory 
file is executable 

set user ID on execution 
none of the above 


{( & XX Ou 


owner can read 
—-2 owner cannot read 


W 
i 
ee 


4we owner can write 
—: owner cannot write . 


5S re non-owner can read 
-s non-owner eannot read 


6 we non-owner can write 
—-s non-owner cannot write 


The owner is almost always given in symbolic 
form; however if he cannot be found in 
/etc/uids a number is given. 


If the number of arguments to stat is not exactly 
4 a header is generated identifying the fields of 
the status information. 


FILES /etc/uids 
SEE ALSO qstat(I), 1s(I) (-1 option ) 
DIAGNOSTICS “name? for any error. 


OWNER amr 
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STRIP (I) 


strip -- remove symbols and relocation bits 


strip name, gece 


strip removes the symbol table and relocation 
bits ordinarily attached to the output of the 
assembler and loader. This is useful to save 
space after a program has been debugged. 


The effect of strip js‘the same as use of the -Ss 
option of ld. 


/tmp/stm? temporary file 

la(I), as(T) 

Diagnostics are given for; non-existent argument; 
jnability to create temporary file; 


improper format (not an object file); 
inability to re-read temporary file. 


amr 


a 
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sTTY (TI) 


stty -- set teletype options 


stty option, eos 


stty will set certain I/O options on the current 
output teletype. The option strings are selected 
from the following set: 


allow even parity. 
disallow even parity. 
allow odd parity 
disallow odd parity 

raw input (no erase/kill) 


negate raw mode (erase/kill) 
allow (and echo) cr for lf. 
negate Cr mode. 


echo back every character typed. 


et 


do not echo characters as typed. 


map upper case to lower case 

do not map case 

map tabs into spaces 

do not map tabs 

calculate cr and tab delays. 

no cr/tab delays 

ebcdic ball conversion (2741 only) 


correspondence ball conversion (2741 only) 


standard output. 


stty( IT) 


“Bad options. 


jfo 
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SU (TI) 


sy -— become privileged user 


su password 


su allows one to become the super-user, who has 
all sorts of marvelous powers, In order for su 
to do its magic, the user must pass as an argu- 
ment a password. If the password is correct, su 
will execute the shell with the UID set to that 
of the super-user. To restore normal UID 
privileges, type an end-of—file to the super—user 
shell. 


sh( I) 


“sorry” if password is wrong 


a oo 
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SUM (TI) 


sum -—- sum file 

sum name, a a 

sum sums the content s of one or more files. A 
separate sum is printed for each file specified, 
along with the number of whole or partial 512- 
word blocks read. 


In practice, Sum is often used to verify that all 
of a special file can be read without error. 


none 


a= oa! 


"opra” if the file cannot opened; "? if if an 
error is discovered during the read. 


none 


ken 


se. Es ae 
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paccT (I) 


tacct -—- login accounting by date 


tacet [ wtmp ] 


tacet will produce a printout giving daily con- 


nect time and total number of connects for all 
transactions found in the wtmp file. If no wtmp 
file is given, /tmp/wtmpis used. 


/tmp/wtmp 

init(VII), acct(TI), login(I), wtmp(V) 
"Cannot open ‘wtmp’ 

acet(I) and tacct(1I) should be compined 


dmr, ken 


-~1- 
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a2 


TAP (T) 


tap -- manipulate DECtape 


tap [key ] [ name ae 


tap saves and restores selected portions of the 
file system hierarchy on DECtape, Its actions 
are controlled by the key argument, The key is a 
string of characters containing at most one func— 
tion letter and possibly one or more function 
modifiers. other arguments to the command are 
file or directory names specifying which files 
are to be dumped, restored, or tabled. 


The function portion of the key is specified by 
one of the following letters: 


r The indicated files and directories, to- 
gether with all subdirectories, are dumped 
onto the tape. If files with the same 
names already exist, they are replaced 
(hence the Tr Ve Same is determined by 
string comparison, so ./abe can never be 
the same as /usr/dmr/abc even if 

/usr/dmr is the current directory. If no 
file argument is given, - is the default. 


u updates the tape. U is the same as x, but 
a file is replaced only if its mod if ication 
Gate is later than the date stored on the 
tape; that is to Say, if it has changed 
Since it was dumped. wu is the default com- 
mand if none is given. 


ad deletes the named files and directories 
from the tape. At least one file argument 
must be given. 


x extracts the named files from the tape to 
the file system. The owner, mode, and 
Gate-modified are restored to what they 
were when the file was dumped, If no file 
argument is given, the entire contents of 
the tape are extracted. 


t lists the names of all files stored on the 
tape which are the same as or are hierarch- 
ically below the file arguments. If no 
file argument is given, the entire contents 
of the tape are tabled. 


1 ais the same as t except that an expand ed 
listing is produced giving all the avail- 
able information about the listed files. 


The following characters may be used in addition 
to the letter which selects the function desired. 


Sos Se «yee 
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mt ( I) 


TAP (I) 


wee, 7 This modifier selects 
which the tape is mount ed. O 
default. 


the drive on 
is the 


Normally tap does its work silently. 
(verbose) option causes it to type the name 
of each file it treats preceded by 4 letter 
to indicate what is happening. 


file 
file 
file 
file 


replaced 
adaed (not 
extracted 
deleted 


is being 
is being 
is being 
is being 


there before) 


ax wh 


d, and 


cd 


The v option can be 
x only. 


used with I, Us 


means a fresh dump jis being created; the 
tape directory will be zeroed before begin- 
ning. Usable only with x and Uu. 


causes new entries copied on tape to be 
‘Fake’ in that only the entries, not the 
data associated with the entries are updat— 
ed. such fake entries cannot be extracted. 
Usable only with £ and U. 


causes tap to pause pefore treating each 
file, type the indicative letter ana the 
file name (as with v) and await the user’s 
response. Response y yes , SO the 
file is treated. Null response meanS NO + 
and the file does not take part in whatever 
is being done. Response x means exit 5; 
the tap command terminates immediately. in 
the xX function, files previously asked 
about have been extracted already. With 2X, 
u, and d no change has been made to the 
tape. 


make (create) @irectories during an if 
necessary. | 


ignore tape errors. It is suggested that 
this option be used with caution to read 


damaged tapes. 


/daev/tap? 


Tape open error 


Tape read error 
Tape write error 
Directory checksum 
Directory overflow 


-2-: 


en, 
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Tape overflow 
Phase error (a file has changed after it was 


selected for dumping but before it was dumped) 


The m option does not work correctly. The i 
option is not yet implement ed. 


ken 


a 
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TM (TI) 


tm -—- provide time information 


[ command arg, «ee. | 


ct 34 
Ss i5 


tm is used to provide timing information. When 
used without an argument, output like the follow- 
ing is given: 


tim 371:51:09 2:00,.8 


ovh 20:00:33 17.0 
swp 13:43:20 4,6 
ask 27:14:35 4,5 
idl 533:08:03 1:33,.3 
usr 24:53350 12 
der 0, 94 0, 8) 


The first column of numbers gives totals in the 
named categories since the last time the system 
was cold—booted; the second column gives the 
changes since the last time tm was invoked. The 
tim row is total real time (hourssminutes;: 
seconds): unlike the other times, its origin is 
the creation date of tm’s temporary file. ovh is 
time spent executing in the system; swp is time 
waiting for swap I/O; dsk is time spent waiting 
for file system disk I/O; idl is idle time; USE 
is user execution time; der is RF disk error 
count (left number) and RK @isk error count 
(right number). 


tm can be invoked with arguments which are as— 
sumed to constitute a command to be timed, in 
this case the output is as follows: 


tim 2a 
ovh 0.3 
swp 0.5 
ask 1.8 
idl 0.0 
usr 0.0 


The given times represent the number of seconds 
spent in each category during execution of the 
command . 


/emp/ttmp, /aev/rf0 (for absolute times) contains 
the information used to calculate the differen-— 
tial times. 


file system(V) 


ee . of 


2" 4f the command cannot be executed; “ean’t 
creat temp file if trouble with ttmp; cant read 
super—block if times cannot be read from system. 
(1) when invoked with a sommand argument, 


24 


TM (T) 


3/15/72 
everything going on at the moment is counted, not 
just the command itself. (2) Two users doing tm 
simult aneously interfere with each other’s use of 
the temporary file. 

OWNER ken, amr 
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Tss (I) 


tss -- interface to Honeywell TSS 


tss 


Tn seal 


tss will call the Honeywell 6070 on the 201 data 


phone. It will then go into direct access with 
T™ss, Output generated by TSS is typed on the 
standard output and input requested by TSS is 
read from the standard input with UNIX typing 
conventions. 


An interrupt signal (ASCII DEL) is transmitted as 
a “break to TSS. 


Input lines beginning with 1 are interpreted as 
UNIX commands, Input lines beginning with _ are 
interpreted as commands to the interface routine. 


“file insert input from named UNIX file 


~Sfile deliver tss output to named UNIX file 


ow 


p pop the output file 


ow 


g disconnect from tss (quit) 
~- file receive from HIS routine CSR/DACCOPY 
~s file send file to HIS routine CSR/DACCOPY 


Ascii files may be most efficiently transmitted 
using the HIS routine csSR/DACCOPY in this 
fashion. Underlined text comes from TSS. 
AFTname is the 6070 file to be dealt with. 


SYSTEM? csR/paAccoPY (s) AFTname 
Send Encoded File §& file 


a en 


SYSTEM? csR/DACCOPY (xr) AFTname 
Receive Fncoded File IF file 


/dev/ano, J/aev/apOd 
DONE when communication is broken. 


when diagnostic problems occur, tSs exits rather 
abruptly. 


csr 
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NAME tty -- get tty name 
SYNOPSIS tty 
DESCRIPTION tty gives the name of the user’s typewriter in 


the form "ttyn for n a digit, The actual path 
name is then jaev/ttyn . 


FILES cs 

SEE ALSO — 

DIAGNOSTICS —  "yot a tty if the standard input file is not 4 
typewriter. | 

BUGS se 


OWNER amr, ken 


oe ee 
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TYPE (TI) 


type -— type on Single sheet paper 


type name, eee 


type copys its input files to the standard out-— 
put, After every 66 lines, type stops and reads 
the standard input for a new line character be— 
fore continuing. This allows time for insertion 
of single sheet paper. 


- 1 = 
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UMOUNT (TI) 


umount —- dismount file system 


/etc/umount special 


umount announces to the system that the removable 
file system previously mount ed on special file 
special is to be removed. 


only the super-—user may issue this command. 


=a o/: 


mount (I) 


? 


This command is not, in fact, restricted to the 
super-user. 


ken, amr 


-~ 1-— 
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UN (TI) 


un -—-—- undefined symbols 


un [ name ] 


un prints a list of undefined symbols from an 
assembly or loader run. If the file argument is 
not specified, a.out is the default. Names are 
listed alphabetically except that non-global sym-—- 
bols come first. Undefined global symbols (un- 
resolved external references) have their first 
char acter underlined, 


a,out 
as(I), 1d( I) 
"o” 4£€ the file cannot be found. 


dmr, ken 
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we (1) 


we — get (English) word count 
we name, eee 


we provides a count of the words, text lines, and 


roft control lines for each argument file. 


A text line is a sequence of characters not be- 
ginning with . and ended by a new-line, A roff 
control line is 4 line beginning with .. A 
word is a sequence of characters bounded by the 
peginning of a line, by the end of a line, or by 
a blank or a tab. 


roff(I) 
none; argument s not found are ignored. 


nue aus 


jfo 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


WHO (T) 


who -- who is on the system 


who [ who-file ] 


who, without an argument, lists the name, type- 


writer Channel, and login time for each current 
UNIX user. 


without an argument, who examines the /tmp/utmp 
file to obtain its information. If a file is 
given, that file is examined. Typically the 
given file will be /tmp/wtmp, which contains a 
record of all the logins Since it was created. 
Then who will list all logins and logouts since 
the creation of the wtmp file. 


/tmp/utmp 
login(I), init(VIT) 


"o" if a named file cannot be read, 


-~-i1- 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


WRITE (I) 


write —- write to another user 


write user 


write copies lines from your typewriter to that 


of another user. When first called, write sends 
the message 


message from yourname... 


The recipient of the message should write back at 
this point. Communication continues until an end 
of file is read from the typewriter or an inter- 
rupt is sent, At that point write writes "ROT" 
on the other terminal. 


Permission to write may be denied or granted by 
use of the mesg command. at the outset writing 
is allowed. Certain commands, in particular rofft 
and pr, disallow messages in order to prevent 
messy output. | 


If the character "!° is found at the beginning of 
a line, write calls the mini-shell msh to execute 
the rest of the line as a command . 


The following protocol is suggested for using 
write: When you first write to another user, wait 
For him to write back before starting to send. 


Each party should end each message with a dis- 
tinctive signal ( (o) for over is convent ion— 
al) that the other may reply. (oo) (for over 


and out") is suggested when conversation is about 
to be terminated. 


/temp/utmp to find user 
/etc/msh to execute ! 


mesg(I), msh(VITI) 
"ser not logged in"; permission denied. 


admr, ken 


a 


niall 
, 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


BREAK (II) 


break -- set program break 
sys break; addr / break = 17. 


break sets the system’s idea of the highest loca- 
tion used by the program to addr. Locations 
greater than addr and below the stack pointer are 
not swapped and are thus liable to unexpected 
modification. 


An argument of O is taken to mean 8K words. If 
the argument is higher than the stack pointer the 
entire user core area is swapped. 


When a program begins execution via exec the 
break is set at the highest location defined by 
the program and data storage areas. Ordinarily, 
therefore, only programs with growing data areas 
need to use break. 


exec(II) 


none; strange addresses cause the break to be set 
to include all of core. 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


CEMT (ITI) 


cemt —-- catch emt traps 
sys cemt; arg Jf cemt = 29. 


This call allows one to catch traps resulting 
from the emt instruction. Arg is a location 
within the program; emt traps are sent to that 
location. The normal effect of emt traps may be 
restored by giving an arg equal to O. 


Prior to the use of this call, the result of an 
emt instruction is a simulated rts instruction. 
The operand field is interpreted as a register, 
and an rts instruction is simulated for that 
register (after verifying that various registers 
have appropriate values). This feature is useful 
for debugging, since the most dangerous program 
bugs usually involve an rts with bad data on the 


stack or in a register. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


CHDIR (II) 


chdir -- change working directory 


sys chdir; Girname / chdir = 12. 


dirname is address of the pathname of a directo- 


XY» terminated by a O byte. chair causes this 
directory to become the current working directo- 


rye 
chair(I) 


The error bit (c-bit) is set if the given name is 
not that of a directory. 


3/15/72 CHMOD (IL) 


NAME chmod -- change mode of file 


SYNOPSIS sys chmod; name; mode / chmod = 15. 
DESCRIPTION The file whose name is given as the null- 


terminated string pointed to by name has its mode 
changed to mode. Modes are constructed by oxring 
together some combination of the following: 


O01 write, non-owner 

O02 read, non-owner 

04 write, owner 

40 read, owner 

20 executable 

40 set user ID on execution 


Only the owner of a file (or the super-user) may 
change the mode. 


FILES -— 

SEE ALSO  echmod(I) 

DIAGNOSTICS Error bit (c-bit) set if name cannot be found or 
qf current user is neither the owner of the file 
nor the superuser. 

BUGS == 


OWN ER ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


CHOWN (IL) 


chown -- change owner of file 
sys chown; name; owner / chown = 16. 


The file whose name is given by the null- 
terminated string pointed to by name has its own— 
er changed to owner. Only the present owner of a 
file (or the super-user) may donate the file to 
another user. Also, one may not change the owner 
of a file with the set-user-ID bit on, otherwise 
one could create Trojan Horses able to misuse 
other’s files. | 


chown(I), uids(V) 


The error bit (e-bit) is set on illegal owner 
changes. 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


CLOSE (II) 


close -- close a file 


(file descriptor in r0) 
sys close / close = 6. 


Given a file descriptor such as returned from an 
open or creat call, close closes the associated 
file. A close of all files is automatic on exit, 
but since processes are limited to 10 simultane- 
ously open files, close is necessary to programs 
which deal with many files. 


creat(II), open (II) 


The error bit (c-bit ) is set for an unknown file 
descriptor. 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


CREAT (II) 


creat -- create a new file 


sys creat; name; mode / creat = 8. 
(file descriptor in r0O) 


creat creates a new file or prepares to rewrite 
an existing file called name; name is the address 
of a null-terminated string. Tf the file did not 
exist, it is given mode mode; if it did exist, 
its mode and owner remain unchanged but it is 
truncated to O length. 


The file is also opened for writing, and its file 
descriptor is returned in r0O. 


The mode given is arbitrary; it need not allow 
writing. This feature is used by programs which 
deal with temporary files of fixed names. The 
creation is done with a mode that forbids writ— 
ing. Then if a second instance of the program 
attempts a creat, an error is returned and the 
program knows that the name is unusable for the 
momente 


If the last link to an open file is removed, the 
file is not destroyed until the file is closed. 


write(II), close(II) 


The error bit (c-bit) may be set if: a needed 
directory is not readable; the file does not 
exist and the directory in which it is to be 


ereated is not writable; the file does exist and 


is unwritable; the file is a directory. 


3/15/72 

NAME 

SYNOPSIS 
names 
args: 
argi: 

DESCRIPTION 


EXEC (II) 


exec -- execute a file 
sys exec; name; args / exec = 11. 
{.02\O 


argi3; argZ 3 e+e3 O 
Ks e e\O> 


exec overlays the calling process with the named 


file, then transfers to the peginning of the core 
image of the file. The first argument to exec is 
a pointer to the name of the file to be executed. 
The second is the address of a list of pointers 
to arguments to be passed to the file. Conven- 
tionally, the first argument is the name of the 
file. Each pointer addresses a string terminated 
by a null byte. 


There can be no return from the file; the calling 
core image is lost. 


The program break is set from the executed file; 
see the format of a.out. 


Once the called file starts execution, the argu 
ments are passed as follows. The stack pointer 
points to the number of arguments. Just above 
this number is a list of pointers to the argument 
strings. 


sp-> nargs 
argi 


argn 
argi: <arg1\0> 
argn: <argn\0? 


The arguments are placed as high as possible in 
core: just below 60000(8).- 


Files remain open across exec calls. However, 
the illegal instruction, emt, quit, and interrupt 
trap specifications are reset to the standard 


values. (See ilgins, cemts vit, intr.) 


Each user has a real user ID and an effective 
user ID (The real ID jdentifies the person using 
the system; the effective ID determines his ac— 
cess privileges.) exec changes the effective user 
ID to the owner of the executed file if the file 
has the set-user-ID mode. The real user ID is 


not affected. 


3/15/72 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


fork( ITI) 


EXEC (II) 


Tf the file cannot be read or if it is not exe- 
cutable, 
nostic. 


ken, 


amr 


a return from exec constitutes the diag~- 
The error bit (c-bit) is set. 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


EXIT (II) 


exit —- terminate process 


(status in r0O) 
sys exit / exit = 1 


exit is the normal means of terminating a pro- 
cess. All files are closed and the parent pro- 
cess is notified if it is executing a wait. The 
low byte of rO is available as status to the 
parent process. 


This call can never return. 


wait(II) 


3/15/72. 
NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


FORK (II) 


fork -- spawn new process 


sys fork / fork = 2. 
(new process return) 
(old process return) 


fork is the only way new processes are created. 
The new process's core image is a copy of that of 
the caller of fork; the only distinction is the 
return location and the fact that rO in the old 
process contains the process ID of the new pro™~ 
cess. This process ID is used by wait. 


wait(II), exec(II) 


The error bit (c-bit) is set in the old process 
if a new process could not be created because of 


lack of process space. 


See wait(II) for a subtle bug in process destruc~ 
tion. 


ken, amr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


FSTAT (II) 


fstat -- get status of open file 


(file descriptor in r0) 
sys fstat; buf / fstat = 28. 


This call is identical to stat, except that it 
operates on open files instead of files given by 
name. It is most often used to get the status of 
the standard input and output files, whose names 
are unknown. \ 


stat(II) . 


The error bit (c-bit) is set if the file descrip- 
tor is unknown. 


ken, amr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


GETUID (II) 


getuid -- get user identification 


sys getuid / getuid = 24. 
(user ID in rO) 


getuid returns the real user ID of the current 
process. The real user ID identifies the person 
who is logged in, in contradistinction to the 
effective user ID, which determines his access 
permission at each moment. It is thus useful, to 
programs which operate using the set user ID 
mode, to find out who invoked them. 


/etc/uids can be used to map the user ID number 
into a name. 


setuid(II) 


3/15/72 GTTY (II) 


NAME gtty -- get typewriter status 


SYNOPSIS (file descriptor in r0) 
sys gtty; arg / gtty = 32. 


args o=et6 


DESCRIPTION gtty stores in the three words addressed by arg 
the status of the typewriter whose file descrip- 
tor is given in rO. The format is the same as 


that passed by stty. 


FILES -— 

SEE ALSO stty(II) 

DIAGNOSTICS Error bit (c-bit) is set if the file descriptor 
does not refer to a typewriter. 

BUGS ae | 


OWN ER ken, dmr 
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SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


HOG (II) 


hog -- set program in low priority 
sys hog / hog = 34. 


The currently executing process is set into the 
lowest priority execution queue. Background jobs 
that execute a very long time should do this. A 
higher priority will be reinstituted as soon 4S 
the process is dismissed for any reason other 
than quantum overflow. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


ILGINS (II) 


ilgins -- catch illegal instruction trap 
sys ilgins; arg / ilgins = 33. 


ilgins allows a program to catch illegal instruc— 
tion traps. If arg is zero, the normal instruc 
tion trap handling is done: the process is ter- 
minated and a core image is produced. If arg is 
a location within the program, control is passed 
to arg when the trap occurs. 


This call is used to implement the floating point 


Simulator, which catches and interprets 11/45 
floating point instructions. 


fptrap(III) 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


INTR (II) 


intr -- set interrupt handling 
sys intr; arg / intr = 27. 


When arg is 0, interrupts (ASCII DELETE) are 
ignored. When arg is 1, interrupts cause their 
normal result, that is, force an exit. When arg 
is a location within the program, control is 
transferred to that location when an interrupt 
OcCUr Se 


After an interrupt is caught, it is possible to 
resume execution by means of an rti instruction; 
however, great care must be exercised, since all 
I/o is terminated abruptly upon an interrupt. In 
particular, reads of the typewriter tend to re- 
turn with O characters read, thus simulating an 
end of file. 


quit(ITI) 


It should be easier to resume after an interrupt, 
but I don’t know how to make it work. 


ken, amr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


KILL (II) 


kill -- destroy process 


(process number in r0) 
sys kill / kill = 37.3 not in assembler 


kill destroys a process, given its process 
number. 


The process leaves a core image. 


This call is restricted to the superuser, and is 
intended only to kill an otherwise unstoppable 
procesSe 


c-bit set if user is not the super~user, Or if 
process does not exist. 


ken, 


dadmr 


kill has been known to be ineffective. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


| DIAGNOSTICS 


BUGS 


OWN ER 


LINK (IT) 


link -—- link to a file 
sys link; name,; name, / link = 9. 


A link to name, is created; the link has name 
name. . Fither name may be an arbitrary path 
name. 


link(I), unlink(II) 


The error bit (c-bit) is set when name, cannot be 
found; when name, already exists; when the direc— 
tory of name. cannot be written; when an attempt 
is made to link to a directory by a user other 
than the super-user. 


3/15/72 


NAME 
SYNOPSIS 
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FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


MAKDIR (II) 


makdir -—- make a directory 

sys makdir; name; mode / makdir = 14. 

makdir creates an empty directory whose name is 
the null-terminated string pointed to by name. 
The mode of the directory is mode. The special 
entries . and e- are not present. 


makdir can only be invoked by the superuser. 


mkdadir(I) © 


Error bit (c-bit) is set if the directory already 
exists or if the user is not the super-usere 
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FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


MDATE (IIL) 


mdate -—- set modified date on file 


(time to AC-MQ) 
sys mdate; file / mdate = 30. 


File is the address of a null-terminated string 


giving the name of a file. The modified time of 
the file is set to the time given in the AC—MQ 
registers. 


This call is allowed only to the super-user or to 
the owner of the file. 


Error bit is set if the user is not the super- 
user or if the file cannot be found. 


ate eek 
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FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


MOUNT (IIL) 


mount —-~- mount file system 
sys mount; special; name / mount = 21. 


mount announces to the system that a removable 
file system has been mounted on special file 
special; from now on, references to file name 
will refer to the root file on the newly mounted 
file system. Special and name are pointers to 
null-terminated strings containing the appropri- 
ate path names. 


Name must exist already. If it had useful con- 
tents, they are jnaccessible while the file sys- 
tem is mounted. 


Almost always, name should be a directory so that 
an entire file system, not just one file, may 
exist on the removable device. 


mount(I), umount(IT) 


Error bit (c-bit) set if special is inaccessible 
or dir does not exist. 


At most two removable devices can be mounted at a 
time. The use of this call should be restricted 
to the superuser. 


ken, dmr 


—_ 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


OPEN (ITI) 


open -- open for reading or writing 


sys open; name; mode / open = 5. 
(descriptor in r0) 


open opens the file name for reading (if-mode is 
0) or writing (if mode is non-zero). mame is the 
address of a string of aAscil characters 
representing a path name, terminated by a null 


character. 


The file descriptor should be saved for subse- 
quent calls to read (or write) and close. 


In both the read and write case the file pointer 
is set to the beginning of the file. 


If the last link to an open file is removed, the 
file is not destroyed until it is closed. | 


creat(II), read(II), write(II), close(II) 


The error bit (c-bit) is set if the file does not 
exist, if one of the necessary directories does 
not exist or is unreadable, or if the file is not 
readable. 
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NAME 
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DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


QUIT (II) 


quit -- turn off quit signal 
sys quit; flag / quit = 26. 


When flag is 0, this call disables quit signals 
from the typewriter (ASCII FS). When flag is 1; 
quits are re-enabled, and cause execution to 
cease and a core image to be produced. When flag 
is an address in the program, a quit causes con 
trol to be sent to that address. 


Quits should be turned off only with due con- 
sideration. 


intr(II) 
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DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


READ (IT) 


read -- read from file 


(file descriptor in r0) 
sys read; buffer; nchars / read = 3. 


(nread in rO) 


A file descriptor is a word returned from a suc— 


cessful open call. 


Buffer is the location of nchars contiguous bytes 
into which the input will be placed. It is not 
guaranteed that all nchars bytes will be read, 
however; for example if the file refers to a 
typewriter at most one line will be returned. In 
any event the number of characters read is re- 
turned in r0O. 


If rO returns with value O, then end-of-file has 
been reached. 


open(IT) 


As mentioned, rO is O on return when the end of 
the file has been reached. If the read was 
otherwise unsuccessful the error bit (c-bit) is 
set. Many conditions, all rare, can generate an 
error: physical I/O errors, bad buffer address, 
preposterous nchars, file descriptor not that of 
an input file. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


RELE (II) 


rele -- release processor 


sys rele / rele = 0; not in assembler 


This call causes the process to be swapped out 
immediately if another process wants to run. Its 
main reason for being is internal to the system, 
namely to implement timer-runout swaps. However, 
it can be used beneficially by programs which 


wish to loop for some reason without consuming 
more processor time than necessarye 


ken, dmr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


SEEK (II) 


seek -- move read/write pointer 


(file descriptor in r0) : 
sys seek; offset; ptrname / seek = 19. 


The file descriptor refers to a file open for 
reading or writing. The read (or write) pointer 
for the file is set as follows: 


if ptrname is 0, the pointer is set to offset. 


if ptrname is 1, the pointer is set to its 
current location plus offset. 


if ptrname is 2, the pointer is set to the 
size of the file plus offset. 


tell(II) 


The error bit (c-bit) is set for an undefined 
file descriptor. 


A file can conceptually be as large as 2**20 
bytes. Clearly only 2**16 bytes can be addressed 
by seek. The problem is most acute on the tape 
files and RK and RF. Something is going to be 
done about this. 


ken, amr 
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SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


SETUID (IIL) 


setuid -- set process ID 


(process ID in r0) 
sys setuid / setuid = 23. 


The user ID of the current process is set to the 
argument in rO. Both the effective and the real 
user ID are set. This call is only permitted to 
the super-user or if rO is the real user ID. 


getuid(II) 


Error bit (c-bit) is set if the current user ID 
is not that of the super-user. 
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NAME 


SYNOPSIS 
DESCRIPTION 
FILES 

SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


SLEEP (II) 


sleep -- stop execution for interval 


(60ths of a second in rO) 


sys 
The 


for 
the 


Due 


sleep / sleep = 35.; not in assembler 
current process is suspended from execution 


the number of 60ths of a second specified by 
contents of register O. 


to the implementation, the sleep interval is 


only accurate to 256 60ths of a second (4.26 
sec). Even then, the process is placed on a low 
priority queue and must be scheduled. 


ken, 


dmr 
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NAME stat -- get file status 
SYNOPSIS sys stat; name; buf / stat = 18. 
DESCRIPTION name points to a null-terminated string naming a 


file; buf is the address of a 34(10) byte buffer 
into which information is placed concerning the 
file. It is unnecessary to have any permissions 
at all with respect to the file, but all direc- 


tories leading to the file must be readable. 


After stat, buf has the following format: 


buf, +1 i-number 

+2,+3 flags (see below) 

+4 number of links 

+5 3 user ID of owner 

+6,+7 size in bytes 

+8,+9 first indirect block or contents block 
+22,%+23 eighth indirect block or contents block. 


+24,+25,+26,+27 creation time 
+28,+29, 430,431 modification time 
+32,+33 unused 


The flags are as follows: 


400000 used (always on) 

040000 directory _— 

020000 file has been modified (always on ) 
010000 large file 

000040 set user ID 

000020 executable 

000010 read, owner 

000004 write, owner 

000002 read, non-owner 

000001 write, non-owner 


FILES _— 

SEE ALSO stat(I), fstat(II) 

DIAGNOSTICS Error bit (c-bit) is set if the file cannot be 
found. 

BUGS The format is going to change someday. 


OWNER ken, dmr 
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SYNOPSIS 
DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


STIME (II) 


stime -- set time 


(time in AC-MQ) 
sys stime / stime = 25. 


stime sets the system’s idea of the time and 
Gate. Only the super-user may use this call. 


date(I), time( II) 


Frror bit (c-bit) set if user is not the super- 
user. 


ken, dmr 
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NAME 
SYNOPSIS 
arg: 
DESCRIPTION 


sTTY (II) 


stty -— set mode of typewriter 


(file descriptor in r0) 
sys stty; arg / stty = 31. 


dersr; dcepsr; mode 


stty sets mode bits for a typewriter whose file 
descriptor is passed in r0. First, the system 
delays until the typewriter is quiescent. Then, 
the argument dersr is placed into the typewri- 
ter’s receiver control and status register, and 
depsr is placed in the transmitter control and 
status register. The DC-11 manual must be con- 
sulted for the format of these words. For the 
purpose of this call, the most important role of 
these arguments is to adjust to the speed of the 
typewriter. | 


The mode arguments contains several bits which 
determine the system's treatment of the 
typewriter: 


2700 even parity allowed on input (e. ge for m37s) 
400 odd parity allowed on input 

040 raw mode: wake up on all characters 

020 map CR into LF; echo LF or CR as LF-CR 

010 echo (full duplex ) 

004 map upper case to lower on input (e-. g- M33) 
002 echo and print tabs as spaces 

001. inhibit all function delays (e. g- CRTs) 


Characters with the wrong parity, as determined 
by bits 200 and 100, are ignored. 


In raw mode, every character is passed back im- 
mediately to the program. No erase or kill pro- 
cessing is done; the end-of—-file character (EOT), 
the interrupt character (DELETE) and the quit 
character (FS) are not treated specially. 


Mode 020 causes input carriage returns to be 
turned into new-lines; input of either CR or LF 
causes LF-CR both to be echoed (used for GE Ter 
miNet 300’s and other terminals without the new” 
line function). 


Additional bits in the high order byte of the 
mode argument are used to indicate that the ter- 
minal is an IBM 2741 and to specify 2741 modeSe 
These mode bits ares : 


400 terminal is an IBM 2741 

4000 the 2741 has the transmit interrupt feature 
(currently ignored) 

2000 use correspondence code conversion on outfit 


4 


6/12/72 STTY (IL) 


4000 use correspondence code conversion on input 
(currently ignored) 


Normal input and output code conversion for 2741s 
is EBCDIC (e. ge 963 ball and corresponding key 
board). The presence of the transmit interrupt 
feature permits the system to do read-ahead while 
no output is in progress. In 2741 mode, the low 
order bits 331 are ignored. 


FILES -— 

SEE ALSO stty(I), gtty(II) 

DIAGNOSTICS The error bit (c-bit) is set if the file descrip- 
tor does not refer to a typewriter. 

BUGS This call should be used with care. It is all 


too easy to turn off your typewriter. 


OWN ER ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


SYNC (II) 


sync -- update super—block 


sys sync / sync = 36.3; not in assembler 


sync causes the super block for all file systems 


to be written out. It is only necessary ON sys- 
tems in which this writing may be delayed fora 
long time, i.@., those which incorporate hardware 
protection facilities. 


It should be used by programs which examine a 
file system, for example check, df, tm, etc. 


3/15/72 
NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


TELL (II) 


tell -- get file pointer 


(file descriptor in r0) | 
sys tell; offset; ptrname / tell = 20. 
(value returned in r0) 


The file descriptor refers to an open file. The 
value returned in rO is one of: 


if ptrname is 0, the value returned is offset; 


ee 


if ptrname is 1, the value is the current 
pointer plus offset; 


if ptrname is 2, the value returned is the 
number of bytes in the file plus offset. 


seek (II) 


The error bit (c-bit) is set if the file descrip- 
tor is unknown. 


Tell doesn’t work. Complain if you need it. 


ken, dmr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


TIME (ITI) 


time -- get time of year 


sys time 
(time AC-MQ) 


time returns the time since 00:00:00, Jan. 1, 
1971, measured in sixtieths of a second. The 
high order word is in the AC register and the low 
order is in the MQ. 


date(I), stime(II) 


The chronological-minded user will note that 
2*##32 sixtieths of a second is only about 2.5 
years. 


ken, 


amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


UMOUNT (II) 


umount --— dismount file system 


sys umount; special / umount = 22. 


@ 


ywmount announces to the system that special file 
special is no longer to contain a removable file 
system. The file associated with the special 
file reverts to its ordinary interpretation (see 
mount). 


The user must take care that all activity on the 
file system has ceased. 


umount(I), mount(ITI) 


Error bit (c-bit) set if no file system was 
mounted on the special file. 


Use of this call should be restricted to the 
super-uSere 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


UNLINK (II) 


unlink —-- remove directory entry 
sys unlink; name / unlink = 10. 


Name points to a null-terminated string. Unlink 
removes the entry for the file pointed to by name 
from its directory. If this entry was the last 
link to the file, the contents of the file are 
freed and the file is destroyed. If, however, 
the file was open in any process, the actual des- 
truction is delayed until it is closed, even 
though the directory entry has disappeared. 


rm(I), rmdir(I), Link(II) 


The error bit (c-bit) is set to indicate that the 
file does not exist or that its directory cannot 
be written. Write permission is not required on 
the file itself. It is also illegal to unlink a 
directory (except for the super-user )- 


Probably write permission should be required to 
remove the last link to a file, but this gets in 
other problems (namely, one can donate an un~ 
deletable file to someone else). 


If the system crashes while a file is waiting to 
be deleted because it is open, the space is lost. 


ken, dmr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


WAIT (ITI) 


wait -— wait for process to die 


sys wait / wait = 7. 
(process ID in r0) 
(termination status/user status in MQ) 


wait causes its caller to delay until one of its 
child processes terminates. If any child has 
already died, return is immediate; if there are 
no children, return is immediate with the error 
bit set. In the case of several children several 
waits are needed to learn of all the deaths. 


If the error bit is not set on return, the MQ 
high byte contains the low byte of the child pro- 
cess rO when it terminated. The MQ low byte con- 
tains the termination status of the process from 
the following list: 


exit 

bus error 

trace trap 

illegal instruction 
IOoT trap 

power fail trap 
EMT trap 

bad system call 
quit 

interrupt 

kill (see kill(II)) 
core image produced 


ODANANAhWN | O 


+ —> 
= © 
0) 


exit(II), fork(II) . 


error bit (c-bit) on if no children not previous— 
ly waited for. 


A child which dies but is never waited for is not 
really gone in that it still consumes disk Swap 
and system table space. This can make it impos-— 
sible to create new processes. The bug can be 
noticed when several & separators are given to 
the shell not followed by a command without an 
ampersand. Ordinarily things clean themselves up 
when an ordinary command is typed, but it is pos- 
sible to get into a situation in which no com— 
mands are accepted, so no waits are done; the 
system is then hung. 


The fix, probably, is to have a new kind of fork 
which creates a process for which no wait is 
necessary (or possible); also to limit the number 
of active or inactive descendants allowed to a 
proc 2SS. 


3/15/72 
NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


WRITE (II) 


write mm write on file 


(file descriptor in r0) 
sys write; buffer; nchars / write = 4. 
(number written in r0) 


A file descriptor is a word returned from a suc— 
cessful open or creat call. 


buffer is the address of nchars contiguous bytes 
which are written on the output file. The number 
of characters actually written is returned in r0O. 
It should be regarded as an error if this is not 
the same as requested. 


For d@isk and tape files, writes which are multi- 
ples of 512 Characters long and begin on a 
542-byte boundary are more efficient than any 
others. 


creat(II), open(II) 


The error bit (c-bit) is set on an error: bad 
descriptor, buffer address, or count. physical 
I/O errors; 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


ATAN, ATAN2 (III) 


atan -- are tangent function 

jsr r5,atan[2] 

The atan entry returns the arc tangent of frO in 
frO. The range is zero to pi/2. The atan2 entry 
returns the arc tangent of fr0/fri in frO. The 
range is -pi to pi. The floating point simula- 


tion should be active in either floating or dou- 
ble mode, but in single precision integer mode. 


kept in /usr/lib/liba.a 
fptrap(IITI) 


rhm, admr, ken 
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NAME atof -- ascii to floating 
SYNOPSIS ASL r5,atof; subr 
DESCRIPTION atof will convert an ascii stream to a floating 


number returned in frO. The subroutine subr is 
called on r5 for each character of the ascii 
stream. subr should return the character in r0. 
The first character not used in the conversion is 
left in rO. The floating point simulation should 
be active in either floating or double mode, but 
in single precision integer mode. 


FILES kept in /usr/lib/liba.a 

SEE ALSO fptrap(IITI) 

DIAGNOSTICS -—— 

BUGS The subroutine subr shoulda not disturb any regis 
ters. 


OWNER ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


ATOL (III) 


atoi -- ascii to integer 
jsxr r5,atoi; subr 


atoi will convert an ascii stream to a binary 


number returned in mq- The subroutine subr is 


called on r5 for each character of the ascii 
stream. subr shoulda return the character in r0. 
The first character not used in the conversion is 
left in rO. 


kept in /Jusr/lib/liba.a 


eh <a 


The subroutine subr should not disturb any regis- 
terSe 


ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


CONST (III) 


const -- floating point constants 


The following floating point constants are 
correctly represented in double precision. 


one 1.0 
pi2 0. 5*3.14156 6-6 


kept in Jusr/lib/liba.a 
fptrap(III) 


rhm, dmr, ken 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


CTIME (III) 


ctime -- convert date and time to ASCII 


(move time to AC-MQ) 
mov sbuffer,r0O 
jsr pc,ctime 


The buffer is 15 characters long. The time has 
the format | 


Oct 9 17232324 


The input time is in the AC and MQ registers in 
the form returned by sys time. 


kept in /usr/lib/liba.a 


ptime(III), time(II) 


a 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


EXP (III) 


exp —— exponential function 

jsxr r5,eXP 

The exponential of frO is returned in frO. The 
floating point simulation should be active in 


either floating oF double mode, but in single 
precision integer mode. 


kept in /usr/lib/liba.a 
fptrap(III) 


The c-bit is set if the result is not represent— 
able. 


rhm, dmr, ken 


__ 
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NAME 


SYNOPSIS 


DESCRIPTION 


FPTRAP (III) 


fptrap -—- ppp-11/45 floating point simulator 


~globl fptrap 
sys ilgins; fptrap 


fptrap is a package which picks up instructions 
“hich are illegal for the ppp-11/20, and if they 
correspond to 11/45 floating point instructions, 
simulates their operation. The following in- 
structions are supported: 


cfcc 

setf 

seti 

setd 

setl 

clrf fdst 

tstf fsre 

absf fdst 

negf fdst 

mulf fsrc,fr 

modft ferc,ir 

addf fsrc,fr 

movt fsrc,fr (=ldf) 
movft fr,fdst (=stf ) 
subf fsrc,fr 

cempf fsrc,fr 

divt fsrce,fr 

movfi fr,dst (=stefi) 
mov if src,fr (=ldcif ) 
movfo fr,fdst (=stcxy) 
movoft fsrc,fr (=ldcyx) 


Here sre and dst stand for source and destina- 
tion, fsre and fast for floating source and des~ 
tination, and fr for floating register. Notice 
that the names of several of the opcodes nave 


changed. The only strange instruction is move » 


which turns into stf if its source operand is a 


floating register, and into ldf if not. 


The simulator sets the floating condition codes 
on both laf and stf.- The 11/45 hardware does not 
set the fcc on stf. 


Short and long format for both floating point 
numbers and integers is supported. Truncation 
mode is always in effect. Traps for overflow and 
other arithmetic errors are not supported. Tlle- 
gal instructions or addresses cause a simulated 
trap so that a core image is produced. | 


The condition code bits are maintained correctly: 


For floating-point source operands, immediate 
mode ((pe)+) is not supported, since the 


—- 1- 
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FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


FPTRAP (III) 


PpP-11/45 handbook is not clear on what to do 
about it. 


After an arithmetic error the result is generally 
meaningless. | 


The arithmetic is always done in double- 
precision, so exact but unrounded results are to 
be expected in single-precision mode. Double 
precision results are probably less correct than 
the hardware will be. | 


The lower parts of the floating registers become 
meaningless during single-precision operations. 


kept in /usr/lib/liba.a 
PppP-11/45 handbook, ilgins(ITI) 
trap, c-bit, v-bit 

see above 


ken, dmr 


De 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


FTOA (IIL) 


ftoa floating to ascii conversion 
jsr r5,ftoa; subr 


ftoa will convert the floating point number in 
fro into ascii in the form [-]a.dddddaddde [-]da*. 
The floating point simulator should be active in 
either floating or double mode, but in single 
integer mode. For each character generated by 
ftoa, the subroutine subr is called on register 
r5 with the character in rQ. 


kept in /usr/lib/liba.a 
fptrap(III) 


The subroutine subr should not disturb any regis~ 
terSe 


ken 


~ 


a, a rere 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


CONNECT, GERTS (III) 


connect, gerts —- Gerts communication over 201 


jsr r5,connect 
(error return )/ 


jer. r5,gerts; fc; OC; ibuf; obuf 
(error return) 


eo e 


The GECOS GERTS interface is so bad that a 
description here is inappropriate. Anyone need- 
ing to use this interface should contact the Own 
er. 


/aev/ano, /dev/dapo 
kept in /usr/lib/liba.a 


an(Iv), a@p(Iv), HIS documentation 


ken 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


GETC, GETW, FOPEN (III) 


getw, getc, fopen -- buffered input 
mOv sfilename,r0O 

jsr r5,fopen; iobuf 

jsr r5,getc; iobuf 


(character in r0) 


jsr r5,getw; iobuf 
(word in r0) 


These routines are used to provide a buffered 
input facility. sobuf is the address of a 
518(10) byte buffer area whose contents are main-~ 
tained by these routines. Its format is; | 


joptr: e=e+2 | / file descriptor 
e=et2 / characters left in buffer 
e=et2 / ptr to next character 
eae t512- / the buffer 


fopen may be called initially to open the file. 
On return, the error bit (c-bit) is set if the 
open failed. If fopen is never called, get will 
read from the standard input file. 


getc returns the next byte from the file in r0O. 
The error bit is set on ena of file or a read 


erroOre 

getw returns the next word in r0. gete and getw 
may be used alternately; there are no odd/even 
problems. 


jobuf must be provided by the user; it must be on 
a word boundary. 


kept in /usr/lib/liba.a 
open(II), read(II), putce(III) 


c-bit set on EOF or error 


amr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


HYPOT (III) 


hypot -- calculate hypotenuse 


(A in fr0) 

(B in frO) 

jsrxr r5,hypot 

The square root of frO*frO + fri*fri is returned 
in frO. The calculation is done in such a way 
that overflow will not occur unless the answer is 
not representable in floating point. 


The floating point simulator should be active in 
either single or double mode. 


kept in /usr/lib/liba.a 
fptrap(IITI) 


The c-bit is set if the result cannot be 
represented. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


ITOA (III) 


jtoa -- integer to ascii conversion 
jsr r5,itoa; subr 


jtoa will convert the number in rO into ascii 


FED EL ETI 


decimal possibly preceded by a — sign. For each 
character generated by itoa, the subroutine subr 
is called on register r5 with the character in 
rO. 


kept in /usr/lib/liba.a 


The subroutine subr should not disturb any regis- 
ters. 


ken 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


LOG (III) 


log -—- logarithm base e 
jsr r5,109g 


The logarithm base e of frQ is returned in fr0. 
The floating point simulation should be active in 
either floating or double mode, but in single 
precision integer mode. aa : 

ies 


kept in /usr/lib/liba.a 


fptrap 4s 


The error bit (c-bit) is set if the input argu- 
ment is less than or equal to zero. 


ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


MESG (III) 


mesg -- write message on typewriter 


jsr r5,mesg; <Now is the time\O>; .even 


mesg writes the string immediately following its 
call onto the standard output file. The string 
js terminated by a O byte. 


kept in /usr/lib/liba.a 


——agper~ > ag 


ater Mee. 
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NAME 
SYNOPSIS 


file: 
list: 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


NLIST (III) 


nlist -- get entries from name list 


jsr r5,nlist; file; list 


<file name\0O> 


<name1xxx>3; type1; value 
<name2xxx>; type2; value2 


0 


nlist will examine the name list in an assembler 
output file and selectively extract a list of 
values. The file name is a standard UNIX path 
name. The name list consists of a list of 8- 
character names (null padded) each followed by 
two words. The list is terminated with a zero. 
Fach name is looked up in the name list of the 
file. If the name is found, the type and value 
of the name are placed in the two words following 
the name. If the name is not found, the type 
entry is set to —1.- 


This subroutine is useful for examining the sys~- 
tem name list kept in the file /sys/sys/unix. In 
this way programs can obtain system ‘magic’ 
numbers that are up to date. 


kept in /usr/lib/liba.a 
a,out(v) 


All type entries are set to —1 if the file cannot 
be found or if it is not a valid namelist. 


ken 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


PTIME (IIT) 


ptime -— print date and time 
(move time to ac—mq ) 
MOV file,rO 
jsx pc, ptime 
ptime prints the date and time in the form 
Oct 9 17320333 
on the file whose file descriptor is in rO. The 
string is 15 characters long. The time to be 
printed is placed in the AC and MQ registers in 
the form returned by sys time. 
kept in /usr/lib/liba.a 
time(I1), ctime(III) (used to do the conversion) 


see ctime 


dmr, ken 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


PUTC, PUTW, FCREAT, FLUSH (IIL) 


putc, putw, fcreat, flush -- buffered output 


mov sfilename,rO 
jsr r5,fcreat; iobuf 


(get byte in r0) 
jsr r5,putc; iobuf 


(get word in r0) 
jsrxr r5,putw; iobuf 


jsr r5,flush; iobuf 


fFoereat creates the given File (mode 17) and sets 
up the buffer fobuf (size 518(10) bytes); putc 
and putw write a byte or word respectively onto 
the file; flush forces the contents of the buffer 
to be written, but does not close the file. The 
format of the buffer is: 


jobuf: e=et2 / file descriptor 
e=et2 / characters unused in buffer 
e=et2 / ptr to next free character 
ee t512-6 / buffer 


fereat sets the error bit (c-bit) if the file 
creation failed; none of the other routines re~ 
turn error information. 


Before terminating, a program should call flush 
to force out the last of the output. 


The user must supply jobuf, which should begin on 
a word boundary. 


kept in /usr/lib/liba.a 
creat(II), write(II), getc(III) 


error bit possible on fereat call 


amr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
‘DIAGNOSTICS 


BUGS 


OWNER 


qsort -- quicker sort 


(base of data in ri) 
(end of data in r2 ) 
(element width in r3) 
jsr pc,qsort 


QSORT (III) 


gsort is an implement ation of the quicker sort 
algorithm, It js designed to sort equal length 
pyte strings. Registers r1 and r2 delimit the 
region of core containing the array of byte 
strings to be sorted: r1 points to the start of 


the first string, r2 to the first 


location above 


the last string. Register r3 contains the length 
of each string. r2-ri should be a multiple of 
r3. On return, r0, r1, r2, V3, r4, AC and MQ are 


destroyed. 


The user should be able to supply 
json routine. 


ken 


his own compar- 
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NAME salloc -- string man ipulation rout ines 
SYNOPSIS (get size in r0) 
jsr pc,allocate 


(get source pointer in r0, 
destination pointer in ri) 


jsr pc, COpy 
jsr pc,we 


(all following instructions assume r1 contains pointer ) 


jsr pe,release 
(get character in r0) 
jsr pc, putchar 
jsr pc, lookchar 


(character in rO) 


jsr pe, getchar 
(character in r0O) 


(get character in r0) 


jsr pe, alterchar 
(get position in r0) 
jer pe, seekchar 
jsr pc, backspace 
(character in r0) 
(get word in r0) 

jsr pc, putword 
pc, Llookword 
word in r0) 


jsr pe,getword 
(word in r0) 


(get word in r0O) 
jsr pc, alterword 


jsr pc, backword 
(word in r0) 


jsr pc,length 
(length in r0) © 


jsr pc, position 
(position in r0) 


jsr pe,rewind 


am | GH 
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DESCRIPTION 


SALLOC (III) 


jsr pe,create 
jer pe, fsfile 
jsr pe,zero 


This package is & complete set of routines for 
dealing with almost arbitrary length strings of 
words and bytes. The strings are stored on a 
disk file, so the sum of their lengths can be 
considerably larger than the available cores 


For each string there is a header of four words, 
namely a write pointer, & read pointer and 
pointers to the beginning and end of the biock 
containing the string. Initially the read and 
write pointers point to the beginning of the 
string. All routines that refer to a string 
require the header address in rie Unless the 
string is destroyed by the call, upon return r1 
will point to the same string, although the 
string may have grown to the extent that it had 
to be be mov ed « 


allocate obtains a string of the requested size 
and returns a pointer to its header in rie 


release releases 4 string back to free storagee 


putchar and putword write a byte or word respec 


tively into the string and advance the write 
pointere 


lookchar and lookword read a byte or word respec 
tively from the string but do not advance the 
read pointere 


getchar and getword read a byte or word respec 
tively from the ‘string and advance the read 
pointere 


alterchar and alterword write a byte or word 


respectively into the string where the read 
pointer is pointing and advance the read pointer. 


backspace and packword read the last byte or word 
written and decrement the write pointere 


All write operations will automatically get a 
Larger block if the current block is exceeded. 
All read operations return with the error bit set 
if attempting to read beyond the write pointer. 


seekchar moves the read pointer to the offset 
specified in rO- 


-~2- 
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FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SALLOC (III) 


lenath returns the current length of the string 
(beginning pointer to write pointer) in r0- 


position returns the current offset of the read 
pointer in r0. 


rewind moves the read pointer to the current 
position of the write pointer. 


create returns the read and write pointers to the 
beginning of the string. 
fsfile moves the write pointer to the current 
position of the read pointer. 


zero zeros the whole string and sets the write 
pointer to the beginning of the stringe 


copy copies the string whose header pointer is in 
ro to the string whose header pointer is in rte 
Care should be taken in using the Copy instruc 
tion since r' will be changed 4f the contents of 
the source string is bigger than the destination 
stringe 


we forces the contents of the internal buffers 
and the header blocks to be written on disce 


The allocator proper is in Jusr/1le/alloc/alloca. 


The archive Jusr/1le/alloc/allocb contains the 


individual routines discussed above. 


alloc.d is the tempor ary file used to contain the 
stringse 


ED 


“arror in copy” if a disk write error occurs dur- 
ing the execution of the copy instructione 

error in allocator if any routine is called 
with a bad header pointer. Cannot open output 
file if file alloc.d cannot be created or 
opened. Out of space 4f there’s no available 
biock of the requested size or no headers av ail- 
able for a new blocke 


oer 


llc,rhm 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


SIN, COS (III) 


sin, cos -- sine cosine 

jsx r5,sin (cos) 

The sine (cosine) of fr0 (radians) is returned in 
frO. The floating point simulation should be 
active in either floating or double mode, but in 


single precision integer mode. All floating 
registers are used. 


kept in /usr/lib/liba.a 
fptrap(III) 


ed 


Size of the argument should be checked to make 
sure the result 1s meaningful. 


ken, amr 
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NAME 
SYNOPSIS 


DESCRIPTION 
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SORT (III) 


sqrt -- square root function 

jsrxr r5,sqrt 

The square root of frO is returned in frO. The 
floating point simulation should be active in 
either floating or double mode, but in single 
precision integer mode. 

kept in /usr/lib/liba.a 

fptrap(III) 


The c-bit is set on negative arguments. 


rhm, dmr, ken 
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SWITCH (IIL) 


switch -- switch on value 


(switch value in r0O) 

jsx r5,switch; swtab 
(not-found return ) 

val1; lab‘; 

valn; labn 

ee3 O 


switch compares the value of rO against each of 
the val,; if a match is found, control is 
transferred to the corresponding lab, (after pop- 
ping the stack once). If no match has been found 
by the time a null lab, occurs, switch returns. 


kept in /usr/lib/liba.a 
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DNO (IV) 


anO -- dn-11 ACU interface 


dadnOQ is a write-only file. Bytes written on dnOQ 
must be ASCII digits. Each digit corresponds to 
a digit of a telephone number to be called. The 
entire telephone number must be presented in a 
single write system call. The call must complete 
with the last digit. 


found in /dev 
apO(IV), write(II) 


Cane em 


ken, amr 
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DP (IV) 


apO -—- dp-11 2701 data-phone interface 


dpO is a 201 data-phone interface file. read and 
write calls to apO are limited to a maximum of 
400 bytes. Each write call is sent as a single 
record. Seven bits from each byte are written 
along with an eighth odd parity bit. The sync 
must be user supplied. Each read call returns 
characters received from a single record. Seven 
bits are returned unaltered; the eighth bit is 
set if the byte was not received in odd parity. 

A 20 second time out is set and a zero byte 
record is returned if nothing is received in that 
time. 


found in /dev 
danO(IV), gerts(IITI) 


eam CD 


The dp file is GECOS oriented. It should be more 
flexible. 


ken, dmr 
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LPR (IV) 


/aev/lpr -- line printer 


The line printer special file is the UNIX inter- 
face to a DEC LP-11 line printer. This file may 
only be opened (or creat’ed) for writing. Any- 
thing written on this file is printed on the line 
printer. The following special cases for the 
printer are handled: 


On opening and on closing, the paper is slewed 
to the top of the next page. 


For the 64 character .printer (LP11-FA), all 
lower case letters are converted to upper 
Casee 


Tabs are converted to align on every eighth 
column. 


New lines and form feeds are ignored when the 
printer is at the top of a page. This is done 
so that pr and roff output may be directed to 


the printer and sync on page boundaries even 
with automatic page slew. 


Carriage return and back space can cause mul-— 
tiple printing on a single line to allow for 
overstruck graphics. 


found in /dev 
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MEM (IV) 


mem —-— core memory 


mem maps the core memory of the computer into a 
file. It may be used, for example, to examine, 
and even to patch the system using the debugger. 


Mem is a byte-oriented file; its bytes are num- 
bered O to 65,535. 


found in /dev 


wa? oa” 


If a location not corresponding to implemented 
memory is read or written, the system will incur 
a bus-error trap and, in panic, will reboot it= 
self. 


ken, dmr 
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MTO (IV) 


mtO -—- magtape 


mtQ is the DEC TU10/TM11 magtape. When opened 
for reading or writing, the magtape is rewound. 

A tape consists of a series of 256 word records 
terminated by an end-of-file. Reading less than 
256 words (512 bytes) causes the rest of a record 
to be ignored. Writing less than a record causes 
null padding to 512 bytes. When the magtape is 
closed after writing, an end-of-file is written. 


Seek has no effect on the magtape.e The magtape 
can only be opened once at any instant. 


found in /dev 
mt (1) 


Seek should work on the magtape. Also, a provi- 
sion of having the tape open for reading and 
writing should exist. A multi-file and multi- 
reel facility should be incorporated. 


ken, amr 
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PPT (IV) 


ppt. = punched paper tape 


ppt refers to the paper tape reader or punch, 
depending on whether it is read or written. 


When ppt is opened for writing, a 100-character 
leader is punched. Thereafter each byte written 
is punched on the tape. No editing of the char- 
acters is performed. When the file is closed, a 
400—character trailer is punched. : 


When ppt is opened for reading, the process waits 
until tape is placed in the reader and the reader 
is on-line. Then requests to read cause the 
characters read to be passed back to the program, 
again without any editing. This means that 
several null characters will usually appear at 
the beginning of the file; they correspond to the 
tape leader. Likewise several nulls are likely 
to appear at the end. -Fnd-of-file is generated 
when the tape runs. out. 


Seek calls for this file are meaningless and are 
effectively ignored (however, the read/write 
pointers are maintained and an arbitrary sequence 


of reads or writes intermixed with seeks will 
give apparently correct results when checked with 


tell). 


found in /dev 


ken, dmr 
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RFO (IV) 


rf0 -- RF11-RS11 fixed-head disk file 


el 


This file refers to the entire RF disk. It may 
be either read or written, although writing is 
inherently very dangerous, since a file system 
resides there. , : 


The disk contains 4024 256-word blocks, numbered 
0 to 1023. Like the other plock-structured dev 
ices (tape, RK disk) this file is addressed in 
blocks, not bytes. This has two consequences: 
seek calls refer to block numbers, not byte 
numbers; and sequential reading or writing always 
advance the read or write pointer by at least one 
block. Thus successive reads of 10 characters 
from this file actually read the first 10 charac — 
ters from successive blocks. 


found in /dev 


tapO(IV), rkO(IV) 


The fact that this device is addressed in terms 
of blocks, not bytes, is extremely unfortunate. 
It is due entirely to the fact that read and 
write pointers (and consequently the arguments to 
seek and tell) are single-precision numbers. 

This really has to be changed but unfortunately 
the repercussions are serious. 


ken, amr 
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RKO (IV) 


rkO — RKO3 (or RKOS) disk 


rkOQ refers to the entire RKO3 disk as a single 
sequentially-addressed file. Its 256-word blocks 
are numbered O to 4871. Like the RF disk and the 
tape files, its addressing is block-oriented. 
Consult the rfO(IV) section. 


found in /dev | 
rfoO(IVv), tapO(IV) 
See rfO(IV) 


ken, dmr 
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RPO (IV) 


rpoO -- RP11/RPO2 disk 


rpO refers to the entire RPO2 disk as a single 


sequentially-addressed file. Its 256-word blocks 
are numbered O to 40599. Like the RF disk and 
the tape files, its addressing is block-oriented. 
Consult the rfO(IV) section. 


found in /dev 
rfO(IV), tapO(IV) 


See rfO(IV) | 
Due to a hardware bug, block 40599 on the RP can~ 


not be accessed. 


ken, dmr 
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TAPO ... TAP7 (IV) 


tapO a tap7 


These files refer to DECtape drives 0 to 7. 

Since the logical drive number can be manually 
set, all eight files exist even though at present 
there are fewer physical drives. 


The 256-word blocks on a standard DECtape are 
numbered O to 577. However, the system makes no 
assumption about this number; a block can be read 
or written if it exists on the tape and not oth-— 
erwise. An error is returned if a transaction is 
attempted for a block which does not exist. 


Like the RK and RF special files, addressing on 
the tape files is block-oriented. See the RFO 
section. © 

found in /dev 

/aev/rf0, /dev/rk0 


see /dev/rf0 


ken, dmr 
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TTY (Iv) 


tty — console typewriter 


tty (as distinct from ttyO, eee, ttyn ) refers to 
the console typewriter hard-wired to the PDP-11. 


Generally, the disciplines involved in dealing 
with tty are Similar to those for ttyO -«- and 
the appropriate section should be consulted. The 
following differences are salient: 


The system calls stty and gtty do not apply to 
this device. It cannot be placed in raw modes; on 
input, upper case letters are always mapped into 
lower case letters; a carriage return is echoed 
when a line-feed is typed. 


The quit character is not FS (as with tty0...) p 
but is generated by the key labelled alt mode. 


By appropriate console switch settings, it is 
possible to cause UNIX to come up as a single- 
user system with I/O on this device. 

found in /dev 


ttyO(IV), init(VII) 
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ttyO ... tty/ —— communications interfaces 


ed 


These files refer to pci1 asynchronous communica- 
tions interfaces. At the moment there are eight 
of them, but the number is subject to change. 


When one of these files is opened, it causes the 
process to wait until a connection is esta- 
blished. (In practice, however, user’s programs 
seldom open these files; they are opened by init 
and become a user’s standard input and output 
file.) The very first typewriter file open in a 
process becomes the control typewriter for that 
process. The control typewriter plays a special 
role in handling quit or interrupt signals, as 
discussed below. The control typewriter is in- 
herited by a child process during a fork. 


A terminal associated with one of these files 
ordinarily operates in full-duplex mode. Charac™ 
ters may be typed at any time, even while output 
is occurring, and are only lost when the system's 
character input buffers become completely choked, 
which is rare, or when the user has accumulated 
the maximum allowed number of input characters 
which have not yet been read by some programe 
Currently this limit is 150 characters. When 
this is happening the character # is echoed for 
every lost input character. | 


When first opened, the standard interface mode 
assumed. includes: ASCII characters; .150 baud;. 
even parity accepted; 40 bits/character (one stop 
bit); and newline action character. The system 
delays transmission after sending certain func— 
tion characters; delays for horizontal tab, new 
line, and form feed are calculated for the Tele- 
type Model 37; the delay for carriage return is 
calculated for the GE TermiNet 300. Most of 
these operating states can be changed by using 
the system call stty(II). In particular the fol- 
lowing hardware states are program settable in- 
dependently for input and output (see DC11 
manual): 110, 13495, 450, 300, 600, OF 4200 baud; 
one or two stop bits on output; and 5, 6, 7, OF 8 
bits/character. In addition, the following 
software modes can be invoked: acceptance of even 
parity, odd parity, or both; a raw mode in which 
all characters may be read one at a time; a car~ 
riage return (CR) mode in which CR is mapped into 
newline on input and either CR or line feed (LF) 
cause echoing of the sequence LF-CR; mapping of 
upper case letters into lower case; suppression 
of echoing; suppression of delays after function 
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characters; the echoing of input tabs as spaces; 
and setting the system to handle IBM 27/41s. See 
getty(VII) for the way that terminal speed and 
type are detected. | | 


Normally, typewriter input is processed in units 
of lines. This means that a program attempting 
to read will be suspended until an entire line 
has been typed. Also, no matter how many charac 
ters are requested in the read call, at most one 
line will be returned. It is not however neces— 
sary to read a whole line at once; any number of 
characters may be requested in a read, even one, 
without losing information. 


During input, erase and kill processing is nor- 
mally done. The character # erases the last 
character typed, except that it will not erase 
beyond the beginning of a line or an EOF. The 
character @ kills the entire line up to the 
point where it was typed, but not beyond an EOF. 
Both these characters operate on a keystroke 
basis independently of any backspacing oF tabbing 
that may have been done. Either @ or |#, may 
be entered literally by preceding it by \ 3 the 
erase or kill character remains, but the \. 
disappears. 


It is possible to use raw mode in which the pro- 
gram reading is wakened on each character. The 
program waits only until at least one character 
has been typed. In raw mode, no erase or kill 
processing is done; and the EOT, quit and inter-— 
rupt characters are not treated specially. 


The ASCII EOT character may be used to generate 
an end of file from a typewriter. When an EOT is 
received, all the characters waiting to be read 
are immediately passed to the program, without 
waiting for a new-line. Thus if there are no 
characters waiting, which is to say the EOT oc— 
curred at the beginning of a line, zero charac— 
ters will be passed back, and this is the stan- 
dard end-of-file signal. 


When the carrier signal from the dataset drops 
(usually because the user has hung up his termi~ 
nal) any read returns with an end-of-file indica- 
tion. Thus programs which read a typewriter and 
test for end-of-file on their input can terminate 
appropriately when hung up on. , : 


Two characters have a special meaning when typed. 
The ASCII DEL character (sometimes called rub- 

out”) is the interrupt signal. When this charac~ 
ter is received from a given typewriter, a search 
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is made for all processes which have this type- 
writer as their control typewriter, and which 
have not informed the system that they wish to 
ignore interrupts. If there is more than one 
such process, one of these is selected, for pracy 
tical purposes at random. If interrupts aren’t 
being ignored, the process is either forced to 
exit or a trap is simulated to an agreed-upon 
location in the process. See intr(II). 


The ASCII character FS is the quit signal. Its 
treatment is identical to the interrupt signal 
except that unless the receiving process has made 
other arrangements it will not only be terminated 
but a core image file will be generated. See 
quit(II). 


Output is prosaic compared to input. When one or 
more characters are written, they are actually 
transmitted to the terminal as soon as 
previously-written characters have finished typ- 
ing. Input characters are echoed by putting them 
in the output queue as they arrive. When a pro- 
gram produces characters more rapidly than they 
can be typed, it will be suspended when its out— 
put queue exceeds some limit. When the queue has 
drained down to some threshold the program is 
resumed. Even parity is always generated on out 
put. The EOT character is not transmitted to 
prevent terminals which respond to it from being 
hung uUpe 


The system will handle IBM 2741 terminals. See 
getty(VII) for the way that 2741s are detected. 
In 2741 mode, the hardware state is: 134.5 baud; 
one output stop bit; and 7 bits/character. Be- 
cause the 2741 is inherently half-duplex, input 
is not echoed. Proper function delays are pro- 
vided. For 2741s without a feature known as 
transmit interrupt it is not possible to col- 
lect input ahead of the time that a program reads 
the typewriter, because once the keyboard has 
been enabled there is no way to send further out- 
put to the 2741. It is currently assumed that 
the feature is absent; thus the keyboard is un- 
locked only when some program reads. The inter- 
rupt signal (normally aAscitl DEL) is simulated 
when the 2741 attention key is pushed to gen- 
erate either a 2741 style EOT or a break. It is 
not possible to generate anything corresponding 
to the end-of-file EOT or the quit signal. 
Currently IBM EBCDIC is default for input and 
output; correspondence code output is settable 
(see stty(I)). The full ASCII character set is 
not available: [ , ; ; ‘ » are miss-— 
ing on input and are printed as blank on output; 
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"¢., is used for oe "a for or for both 
ana” *"on output; and ' maps into ‘on 
input. Similar mappings occur with correspon— 
dence code output. 


FILES found in /dev 

SEE ALSO tty(I), getty(VII) 

DIAGNOSTICS -- 

BUGS The primarily Model 37 oriented delays may not be 


appropriate for all other ASCII terminals. 


OWNER ken, dmr, jfo 
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a.out is the output file of the adsembler as 


A.OUT (v) 


} 


, 

a.out -- assembler and link editof output 
/ di 

— / 


y 
nd 
the link editor ld. In both cases, a.out is exe- 
cutable provided there were no errors and no 
unresolved external references. ’ | | 


This file has four sections: a header, the pro- 
gram and data text, a symbol table, and reloca- 
tion bits (in that order). The last two may, be 
empty if the program was loaded with the "“-s 
option of ld or if the symbols and relocation 
have been removed by strip. 


The header always contains 8 words: 


a "br .t20 instruction (407(8) ) 

The size of the program text segment 

The size of the initialized data segment 
The size of the uninitialized (bss) segment 
The size of the symbol table | 

The entry location (always O at present) 
The stack size required (O at present) 

A flag indicating relocation bits have been 
suppressed 3 


OnNAMNAWN: 


The sizes of each segment are in bytes but are 
even. The size of the header is not included in 
any of the other sizes. 


When a file produced by the assembler or loader 
is loaded into core for execution, three logical 
segments are set up: the text segment, the data 
segment, and the uninitialized segment, in that 
order. The text segment begins at the lowest 
location in the core image; the header is not 
loaded. The data segment begins immediately 
after the text. segment, and the bss segment im-—- 
mediately after the data segment. The bss seg- 
ment is: initialized by O’s. In the future the 
text segment will be write-protected and shared. 


The start of the text segment in the file is 
20(8); the start of the data segment is 20+S 
(the size of the text) the start of the reloGa- 


tion information is 20+S,+5,; the start of the 
) 


symbol table is 20+2(S,+5,)°if the relocation 
information is present, 20+s, +5, if not. 


The symbol table consists of 6-word entries. The 
first four contain the ASCII name of the symbol, 
null-padded. The next word is a flag indicating 
the type of symbol. The following values are 
possible: 
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0O undefined symbol 

01 absolute symbol 

O02 text segment symbol 

03 data segment symbol 

04 bss segment symbol 

40 undefined external (.globl) symbol 
41 absolute external symbol 

42 text segment external symbol 

43 data segment external symbol 

44 bss segment external symbol 


Values other than those given above may occur if 
the user has defined some of his own instruc™ 
tions. 


The last word of a symbol table entry contains 
the value of the symbol. 


If the symbol’s type is undefined external, and 
the value field is non-zero, the symbol is inter- 
preted by the loader ld as the name of a common 
region whose size is indicated by the value of 
the symbol. | 


If a.out contains no unresolved global refer- 
ences, the text portions are exactly as they will 
appear in core when the file is executed. If the 
value of a word in the text portion involves a 
reference to an undefined global, the word is 
replaced by the offset to be added to the 
symbol’s value when it becomes defined. 


If relocation information is present, it amounts 
to one word per word of program text or initial- 
jzed data. There is nor location information if 


the “suppress relocation flag in the header is 
on. | 


Bits 3-1 of a relocation word indicate the seg~ 
ment referred to by the text or data word associ- 
ated with the relocation word: 


00 indicates the reference is absolute 
02 indicates the reference is to the text seg- 


ment 

04 indicates the reference is to the data seg- 
ment 

06 indicates the reference is to the bss seg- 
ment 


10 indicates the reference is to an undefined 
external symbol. 


Bit 0 of the relocation word indicates if on that 
the reference is relative to the pe (e.g. clr 
x"); if off, the reference is to the actual sym- 
bol (eege, cir *$x ). 
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The remainder of the relocation word (bits 15-4) 
contains a symbol number in the case of external 
references, and is unused otherwise. The first 
symbol is numbered O, the second 1, etc. 


as ld, strip, MM, un(Z) 
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archive (library) file format 


The archive command ar is used to combine several 
files into one, Its use has three benefits: when 
files are combined, the file space consumed by 
the breakage at the end of each file (256 bytes 
on the average) is saved; directories are smaller 
and less confusing; archive files of object pro- 
grams may be searched as libraries by the loader 
ld. 


A file produced by ar has a “magic number. at the 
start, followed by the constituent files, each 
preceded by a file header, The magic number is 
-147(10), or 177555(8) (it was chosen to be un- 
likely to occur anywhere else). The header of 
each file is 16 bytes long: | 


0-7 | 
file name, null padded on the right 


8-11 
Modification time of the file 


12 
User ID of file owner 


13 
file mode 


44-15 
file size 


If the file is an odd number of bytes long, it is 
padded with a null byte, but the size in the 
header is correct. 


Notice there is no provision for empty areas in 
an archive file. 


ae 
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format of core image 


Three conditions cause UNIX to write out the core 
image of an executing program: the program gen— 
erates an unexpected trap (by a bus error OF 
illegal instruction); the user sends a "quit 
signal (which has not been turned off by the 
program); a trap is simulated by the floating 
point simulator. The core image is called “core 
and is written in the current working directory 
(provided it can be; normal access controls ap- 


ply). 


oe 


The size and structure of the core image file 
depend to some extent on which system is in- 
volved. In general there is a 512-byte area at 
the end which contains the system’s per-—process 
@ata for that process. The remainder represents 
the actual contents of the user’s core area when 
the core image was written. In the current sys- 
tem, this area is variable in size in that only 
the locations from user 0 to the program break, 
plus the stack, is dumped. 


when any trap which is not an t/o interrupt oc- 
curs, all the useful registers are stored on the 
stack, After all the registers have been stored, 
the contents of sp are placed in the first cell 
of the user area; this cell is called u.Sp. 
Therefore, within the core image proper, there is 
an area which contains the following registers in 
the following order (increasing addresses): 


(u.sp)-—>sc 


rO 
pe (at time of fault) 
processor status (at time of fault) 


The last two are stored py the hardware. It fol- 
lows that the contents of sp at the time of the 
fault were (u.sp) plus 22(10). 


The actual location of this data depends on which 
system is being used, In the current system, 
which has relocation and protection hardware, the 
stack discussed above is the system stack, and is 
kept in the per-user area; in older systems, 
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CORE (V) 
there is only one stack, and it is located in the 
user’s core area, 


In general the debugger db(I) should be used to 
deal with core images, 
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format of directories 


A directory behaves exactly like an ordinary 
file, save that no user may write into a directo- 
ry. The fact that a file is a directory is indi- 
cated by a bit in the flag word of its i{-—node 
entry. 


Directory entries are 10 bytes long. The first 
word is the i-node of the file represented by the 
entry, if non-zero; if zero, the entry is empty. 


Bytes 2-9 represent the (8-character) file name, 
null padded on the right. These bytes are not 
necessarily cleared for empty slots. 


By convention, the first twyo entries in each 
directory are for . and ee. .« The first is an 
entry for the directory itself. The second is 
for the parent directory. The meaning of par” AS 
modified for the root directory of the master 
file system and for the root Girectories of re- 
movable file systems. In the first case, there 
is no parent, and in the second, the system does 
not permit off-device references without a mount 
system call. Therefore in both cases " .. 6has 
the same meaning as. - 


file system format 


a. ee 
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format of file system 


re 


Every file system storage volume (e.g. RF disk, 
RK disk, DECtape reel) has a common format for 
certain vital information. 


Every such volume is Givided into a certain 
number of 256 word (512 byte) blocks. Blocks 0 
and 1 are collectively Known as the super-block 
for the device; they define its extent and con- 
tain an i-node map and a free-storage map. The 
first word contains the number of bytes in the 
free-storage map; it is always even. It is fol- 
lowed by the map. There is one bit for each 
block on the device; the bit is 4 if the block 
is free. Thus if the number of free-map bytes is 
n, the blocks on the device are numbered 0 
through 8n-1. The free-map count is followed by 
the free map itself. The bit for block k of the 
device is in byte k/8 of the map; it is offset 
k(mod 8) bits from the right. Notice that bits 
exist for the superblock and the i-list, even 
though they are never allocated or freed. 


after the free map is a word containing the byte 
count for the i-node map. It too is always even. 
T—-numbers below 41(10) are reserved for special 
files, and are never allocated; the first bit in 
the i-node free map refers to ij—number 41. 
Therefore the byte number in the i-node map for 
j-node i is (i-41)/8. It is offset (i-41) (mod 
8) bits from the right; unlike the free map, 4 

0 bit indicates an available i-node. 


I—numbers begin at 1, and the storage for i-nodes 
begins at block 2. Also, j-nodes are 32 bytes 
long, so 16 of them fit into a block. Therefore, 
i-node i is located in block (i431)/16 of the 
file system, and begins 32° ( (41431 ) (mod 16)) bytes 
from its start. 


There is always one file system which is always 
mounted; in standard UNIX it resides on the RF 
disk. This device is also used for swapping. 
The swap areas are at the high addresses on the 
device. It would be convenient if these ad- 
dresses did not appear in the free list, but in 
fact this is not 5S0. Therefore a certain number 
of blocks at the top of the device appear in the 
free map, are not marked free, yet do not appear 
within any file. These are the blocks that show 
up missing in a check of the RF disk. 


Again on the primary file system device, there 
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are several pieces of information following that 
previously discussed, They contain basically the 
information typed by the tm command; namely, the 
times spent since a cold boot in various ca- 
tegories, and a count of I/O errors. In particu- 
lar, there are two words with the calendar time 
(measured since 00:00 Jan 1, 1971); two words 
with the time spent executing in the system; two 
words with the time spent waiting for I/O on the 
RF and RK disks; two words with the time spent 
executing in a user’s core; one byte with the 
count of errors on the RF disk; and one byte with 
the count of errors on the RK disk. All the 
times are measured in sixtieths of a second, 


I-node 41(10) is reserved for the root directory 

of the file system. No i-numbers other than this 
one and those from 1 to 40 (which represent spe- 

cial files) have a built-in meaning. Each i-node 
represents one file, The format of an i-node is 

as follows, where the left column represents the 

offset from the beginning of the i-node:; 


O-1 flags (see below) 

2 number of links 

3 user ID of owner 

4-5 size in bytes 

6-7 first indirect block or contents block 


eee 


20-21 eighth indirect block or contents block 
22-295 creation time 

26-29 modification time 

30-31 unused 


The flags are as follows: 


400000 i-node is allocated 

040000 directory 

020000 file has been modified (always on) 
010000 large file 

000040 set user ID on execution 

000020 executable 

000010 read, owner 

000004 write, owner 

OO00002 read, non-owner 

000001 write, non-owner 


The allocated bit (flag 100000) is believed even 
if the i-node map says the i-node is free; thus 
corruption of the map may cause i-nodes to become 
unallocatable, but will not cause active nodes to 
be reused. 


Byte number n of a file is accessed as follows: n 


‘is divided by 512 to find its logical block 


number (say b) in the file. If the file is small 


a a 
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(flag 010000 is 0), then b must be less than 6, 
and the physical block number corresponding to b 
is the bth entry in the address portion of the 
i-node. 


If the file is large, b is divided by 256 to 
yield a number which must be less than 8 (or the 
file is too large for UNIX to handle). The 
corresponding slot in the i-node address portion 
gives the physical block number of an indirect 
block. The residue mod 256 of b is multiplied by 
two (to give a byte offset in the indirect block) 
and the word found there is the physical address 
of the block corresponding to b. 


If block b in a file exists, it is not necessary 
that all blocks less than b exist. A zero block 
number either in the address words of the i-node 
or in an indirect block indicates that the 
corresponding block has never been allocated. 
Such a missing block reads as if it contained all 
zero words. 


format of directories 


@yo blocks are not enough to handle the i- and 


free-storage maps for an RPO2 disk pack, which 
contains around 10 million words. 
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ident -- IDENT card file 


IDENT (Vv) 


ident is a file used to generate GECOS SIDENT 
cards by the off-line print program opr(I). 
There is one entry per line in the following 


style: 


05:m1234,m/789,name 


which causes the following SIDENT card to be 


generated: 


$ 


kept in jetc/ident. 


opr(T) 


m1234,m789,name 
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passwd -- password file 


passwd contains for each user the following 
informations 


name (login name) 
password 

numerical user ID 

default working directory 
program to use as Shell 


This is an ASCII file. Each field within each 
user’s entry is separated from the next by a 
colon. Fach user is separated from the next by a 
new-line. If the password field is null, no 
password is demanded; if the Shell field is null, 
the Shell itself is used. 


This file, naturally, is inaccessible to anyone 
but the super—user. 


This file resides in directory fetc. 
Jete/init 


super-user 


a. 
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TAP (V) 


tap —— DEC/mag tape formats 


The DECtape command tap and the magtape command 
mt dump and extract files to and from their 
respective tape media. The format of these tapes 
are the same. 


Block zero of the tape is not used. It is avail- 
able as a boot program to be used in a stand 
alone enviornment. This has proved valuable for 
DEC diagnostic programs. 


Blocks 1 thru 24 contain a directory of the tape. 
There are 192 entries in the directory; 8 entries 
per block; 64 bytes per entry. Each entry has 
the following format: 


path name 32 bytes 
mode 1 byte 
uid 1 byte 
size 2 bytes 
time modified 4 bytes 
tape address 2 bytes 
unused 20 bytes 
check sum 2 bytes 


The path name entry is the path name of the file 
when put on the tape. If the pathname starts 
with a zero word, the entry is empty. It is at 
most 32 bytes long and ends in a null byte. 
Mode, uid, size and time modified are the same as 
described under inodes (see file system (v)) The 
tape address is the tape block number of the 
start of the contents of the file. Every file 
starts on a block boundary. The file occupies 
(size+511)/512 blocks of continuous tape. The 
checksum entry has a value such that the sum of 
the 32 words of the directory is zero. 


Blocks 25 on are available for file storage. 


A fake entry (see mt(I), tap(I)) has a size of 
zero. 


filesystem(V), mt(I), tap(I) 
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/etc/uids -- map user names to user IDs 


This file allows programs to map user names into 
user numbers and vice versa. Anyone can read it. 
It resides in directory /etc, and should be up- 
dated along with the password file when a user is 
added or deleted. 


The format is an ASCII name, followed by 4a colon, 
followed by a decimal ASCII user ID number. 


a oe 
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/tmp/utmp —- user information 


a ame 


This file allows one to discover information 
about who is currently using UNIX. The file is 
binary; each entry is 46(10) bytes long. The 
first eight bytes contain a user’s login name or 
are null if the table slot is unused. The low 
order byte of the next word contains the last 
character of a typewriter name (currently, "0° to 
‘5’ for /dev/tty0 to /dev/tty5). The next two 
words contain the user’s login time. The last 
word is unused. 


This file resides in directory /tmp. 


ana» 


/Jetc/init, which maintains the file. 
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/emp/wtmp —— user login history 


This file records all logins and logouts. Its 
format is exactly like utmp(V) except that a null 
user name indicates a logout on the associated 


typewriter, and the typewriter name ‘x’ indicates 
that UNIX was rebooted at that point. 


Wtmp is maintained by login(1I) and init(VII). 


Neither of these programs creates the file, so if 
4t is removed record-keeping is turned off. 


jnit(VII), login(I), tacct(I), acct(T) 


a 
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basic -- DEC supplied BASIC 
basic [file] 


Basic is the standard BASIC VOOO Gistributed as a 
stand alone program. The optional file argument 
is read before the console. See DEC-11-AJ PB-D 
manual. 


Since bas is smaller and faster, basic is not 
maintained on line. 


bas 
See manual 
GOK 


amr 
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be -—- B interpreter 
be [ -c ] sfile,.b .-- ofile, «.. 


be is the UNIX B interpreter. It accepts three 
types of arguments: 


Arguments whose names end with ".b are assumed 

to be B source programs; they are compiled, and 

the object program is left on the file sfile,.o 

(i.e. the file whose name is that of the source 
with ".o substituted for .b ). 


Other arguments (except for "a" ) are assumed to 
be either loader flag arguments, or B-compatible 
object programs, typically produced by an earlier 
be run, or perhaps libraries of B-compatible 
routinese These programs, together with the 
results of any compilations specified, are loaded 
(in the order given) to produce an executable 
program with name a.out. 


The "-c argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 


The language itself is described in [41]. 


The future if B is uncertain. The language has 
been totally eclipsed by the newer, more power 
ful, more compact, and faster language C. 


file.b ; input file 

aout loaded output 

b.tmp1 temporary (deleted) 
b.tmp2 temporary (deleted) 
/usr/lang/bdir/b[ca] translator 
/usr/lang/bdair/brt [12] runtime initialization 
/usr/lib/libb.a builtin functions, etc. 


/usr/lang/bdir/bilib.a interpreter library 


(1] K. Thompson; MM-72-1271-1; Users’ Reference 
to B. | 
c(T) 


see [1]. 


Certain external initializations are illegal. 
(In particular: strings and addresses of exter- 
nals. ) 


ken, amr 
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bj -- the game of black jack 
/usr/games/b3 


Black jack is a serious attempt at simulating the 
dealer in the game of black Jack (or twenty-one) 
as might be found in Reno. 


The following rules apply: 
The bet is $2 every hand. 


A player ‘natural’ (black jack) pays $3. A 
dealer natural loses $2. Both dealer and 
player naturals is a ‘push’ (no money ex- 
change). 


If the dealer has an ace Up, the player is 
allowed to make an ‘insurance’ bet against the 
chance of a dealer natural. If this bet is 
not taken, play resumes as normal. If the bet 
is taken, it is a side bet where the player 
wins $2 if the dealer has a natural and loses 
61 if the dealer does not. 


If the player is dealt two cards of the same 
value, he is allowed to “double’. He is al- 
lowed to play two hands, each with one of 
these cards. (The bet is doubled also; $2 on 
each hand. ) 


If a dealt hand has a total of ten or eleven, 
the player may “double down’. He may double 
the bet (62 to $4) and receive exactly one 
more card on that hand. 


Under normal play, the player may ‘hit’ (draw 
a card) as long as his total is not over 
twenty-one. If the player ‘busts’ (goes over 
twenty-one), the dealer wins the bet. 


When the player ‘stands’ (decides not to hit), 
the dealer hits until he attains a total of © 
seventeen or more. If the dealer busts, the 
player wins the bete 


If both player and dealer stand, the one with 
the largest total wins. A tie is a push. 


The machine deals and keeps SCOre. The following 
questions will be asked at appropriate times. 
Each question is answered by y followed by a new 
line for ‘yes’, or just new line for *no’. 


? means ’do you want a hit?’ 
Insureance? 
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Double down? 


Every time the deck is shuffled, the dealer so 
states and the ‘action’ (total bet) and “stand- 
ing’ (total won or loss) is printed. To exit, 
hit the interrupt key (DEL) and the action and 
standing will be printed. 


ken 
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cal -—-— print calendar 
/usr/ken/cal year 


Cal will print a calendar for the given year. 

The year can be between O (really 1 BC) and 9999. 
For years when several calendars were in vogue in 
different countries, the calendar of England (and 
therefore her colonies) is printed. 


P.S. try cal of 1752. 
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CHASH (VI) 


chash -- precompile a hash table for cref 

chash filei file2 

CHASH takes symbols (character sequences; one per 
line) from file1 and compiles a hash table for 


the use of cref. The table is written on filez2. 


A subroutine suitable for searching such a hash 
table is available from the author. 


There can Only be 199 symbols; they may total 
only 600 characters of text. 


lem 
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cref -—— make cross reference listing 
cref [ -soi ] namei ..-- 


CREF makes a cross reference listing of files in 
assembler format (see AS(I)). The files named as 
arguments in the command line are searched for 
symbols (defined as a succession of alphabetics, 
numerics, ‘.»’, or ‘_', beginning with an alpha- 
betic, °.°, or “_’). 


The output report is in four columns: 


(1) (2) (3) (4) 
symbol file see text as it appears in file 
below 


The third column contains the line number in the 
file by default; the —s option will cause the 
most recent name symbol to appear there instead. 


CREF uses either an ignore file or an only file. 
If the -i option is given, it will take the next 
File name to be an ignore file; if the -o option 
is given, the next file name will be taken as an 
only file. Either ignore or only files must be 
made by chash ee If an ignore file is 
given, all the symbols in the file will be ig- 
nored in columns (1) and (3) of the output. If 
an only file is given, only symbols appearing in 
the file will appear in column (1), but column 
(3) will still contain the most recent name en-— 
countered. Only one of the options -i or -o may 
be used. The default setting is -i; all symbols 
predefined in the assembler are ignored, except 
system call names, which are collected. 


Files t.0, t.1, t.2, t.3 are created (i.e. 
DESTROYED) in the working directory of anyone 
using cref. This nuisance will be repaired soon. 
The output is left in file s.out in the working 
Girectory. 

/usr/lem/s.tab is the default ignore file. 
chash(VI); as(T) 

“line too long- -- input line >131 characters 
“symbol too long” -- symbol >20 characters 

“too many symbols” -- >10 symbols in line 


“cannot open t.?  -- bug; see author 
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“cannot fork; examine t.out’ -- can’t start sort 
process; intermediate results are on files 
t.0, t.1,t.2,t.3. These may be sorted in- 


dependently and the results concatenated by 
the user. 


bad ee 
cannot sort -- odd response from sort; examine 
intermediate results, as above. 


“impossible situation. -- system bug 


“cannot open file -— one of the input names 
cannot be opened for reading. 


BUGS The destruction of unsuspecting users’ files 
should soon be fixed. A limitation that may 
eventually go away is the restriction to assem— 
bler language format. There should be options for 
FORTRAN, English, etC., lexical analysis. 


File names longer than eight characters cause 
misalignment in the output if tabs are set at 
every eigth column. 


OWNER lem 
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das -- disassembler 


A PDP-11 disassembler exists. Contact the owner 
for more information. 


- { - 
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NAME dali -—-- load DEC binary paper tapes 
SYNOPSIS dali output [input] 
DESCRIPTION ali will load a DEC binary paper tape into the 


output file. The binary format paper tape is 
read from the input file (/dev/ppt is default. ) 


FILES /dev/ppt 
SEE ALSO -— 
DIAGNOSTICS "checksum 
BUGS -— 


OWN ER amr 


-{- 
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NAME dpt -—- read DEC ASCII paper tape 
SYNOPSIS dpt output [input] 
DESCRIPTION dpt reads the input file (/dev/ppt default) as- 


suming the format is a DEC generated ASCII paper 
tape of an assembly language program. The output 
is a UNIX ASCII assembly program. 


FILES /dev/ppt 

SEE ALSO -— 

DIAGNOSTICS _—— 

BUGS Almost always a hand pass is required to get a 


correct output. 


OWN ER ken, dmr 


-i1- 
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moo —-- a game 
/usr/games/moo 


moo is a guessing game imported from England. 


3/15/72 


NAME 


SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


PTX (VI) 


ptx — permuted index 


ptx1 input temp 
sort tempi temp2 
ptx2 temp2 output 


ptx generates a permuted index from file input on 
file output. It is in two pieces: the first does 
the permutation, generating one line for each 
keyword in an input line. The keyword is rotated 
to the front. The permuted file must then be 
sorted. ptx2 then rotates each line around the 
middle of the page. 


input should be edited to remove useless lines, 
The, following words are suppressed: <-Sree and , 
as, is ; for , of , on, or, the , to , 


The index for this manual was generated using 
ptx. 
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tmg -- compiler compiler 
tmgq name 


tmg produces a translator for the language whose 

syntactic and translation rules are described in 

file name.t. The new translator appears in a.out 
and may be used thus: 


a,out input [ output ] 
Except in rare cases input must be a randomly 
addressable file. If no output file is speci- 
fied, the standard output file is assumed. 
The tmg language is described in (Reference). 
Jetc/tmg -—- the compiler-—compiler 
/etc/tmga,/etc/tmgb,/etc/tmge -- libraries 
/etc/tmgO0.s —~ global definitions 


22? -- illegal input, offending line follows 
fatal error codes, appear in tmg and a.out: 
ad -- address out of bounds 

so -—- stack overflow 

ga -—- address out of bounds while generating 
Ko -—- too much parse without output 

to -- symbol table overflow 

gn -- getnam on symbol not in table 

Go -- character string overflow 


doug 


—- 1{1-=$ 
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NAME ttt -—- tic-tac-toe 
SYNOPSIS /usr/games/ttt 
DESCRIPTION ttt is the X’s and O’s game popular in ist grade. 


This is a learning program that never makes the 
same mistake twice. 


FILES ttt.k —- old mistakes 
SEE ALSO — 
DIAGNOSTICS os 
BUGS — 


OWN ER ken 
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1000 nul{001 


1010 bs {011 
1920 dle{021 
1030 canj031 
1040 sp |041 
1950 ( 1051 
1960 O 1061 
1070 8 1071 
1400 @ $101 
1410 H {111 
1420 P |121 
1130 X 1131 
1440 * 1141 
1450 h {151 
1460 p ,161 
1470 x $171 
FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 

OWN ER 


ASCII (VII) 


ascii map of ASCII character set 


cat /usr /pub/fascii 


ascii is a map of 
printed as needed, 


ED 


the ASCII character set, to be 
It contains: 


stx}003 etx}!004 eot {005 enq!006 ack{007 bel} 


soh |002 

ht $012 nl {013 vt 1014 np {015 cr {016 sO 1017 si | 

de1!022 dc2j;023 ac3!024 ac4}025 nakj026 syn}027 etb{ 

em |032 subj 033 esc!034 fs {035 gs {036 rs 'O37 us | 
1 $042 1943 # 1044 ¢§ [045 % 1046 & 1047 a 
\ 1952 * 1053 + 1054 , {055 - 1056 . 1957 / | 
1 1062 2 {063 3 {064 4 {065 5 1066 6 1067 7 | 
9 1072 : {073 3 4074 < 1075 = 1076 > 1077 2 | 
aA !102 B {103 C 1404 D {105 E 1406 F {107 G 
riii2 g {113 K $114 L {115 M116 N 1447 0 | 
9 1122 R {123 Ss {124 T 1125 U 1126 ¥ 1427 wi} 
y $132 Z 4133 [ (134 \ 1135 J] $136 ~ {137 _ | 
a {142 b 143 Cc '144 da 1145 e 1146 £ 1447 g 
4 $152 j {1953 kK 1454 1 $155 m {156 n 1457 o | 
q 1162 r {163 s [164 t 1165 u 1166 v 1167 w 
y }i72 2 {173 { 1174 f 1175 } $176 ~ 4177 del} 

found in /usr/pub 
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1730403 


BOOT PROCEDURES (VII) 


bos, maki, rom, vcboot, msys, et al 


On the RF disk, the highest 16K words are 
reserved for stand-alone programs, These 16K 
words are allocated as follows: 


bos (1K) 
Warm UNIX (7K) 
Cold UNIX (8K) 


The UNIX read only memory (ROM) is home cut with 
2 programs of 16 words each. The first (address 
473000) reads bos from the RF disk into core 
location 154000 and transfers to 154000. The 
other ROM program (address 173040) reads a 
DECtape sitting in the end-zone on drive O into 
core location O and transfers to 0. This latter 
operation is compatible with part of DEC’s stan- 
dard ROM. The disassembled code for the UNIX ROM 
follows: 


mov $177472,r0 127003177472 
mov $3,-(r0) 1274033 

mov $140000,-—(r0 ) 12740 3140000 
mov $154000,-(r0) 127403154000 
MOV $—2000,-(r0) 42740;176000 
mov $5,-(r0) 1274035 

tstb (r0 ) 105710 

bge o-2 2376 

jmp #154000 4373154000 
mov $177350,r0 127003177350. 
clr =( 50) 5040 

mov r0,-(r0) 10040 

mov $3,-(r0) 1274033 

tstb (r0 ) 105710 

bge eZ 2376 

tst *$177350 57373177350 
bne . 1377 

movb $5,(x0) 11271035 
tstb (r0O) 105710 

bge 0-2 2376 

clr pc 5007 


The program bos (Bootstrap Operating System) 
examines the console switchs and executes one of 
several internal programs depending on the set-— 
ting. The following settings are currently 
recognized: — 


227 Will read Warm UNIX from the RF into core 
location O and transfer to 600, 


1 will read Cold UNIX from the RF into core 


a. ar 
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location O and transfer to 600. 


10 Will dump all of memory from core loca- 
tion O onto DECtape drive 7 and then 
halt. 
20 Will read 256 words from RKO into core O 


ana transfer to zero. This is the pro- 
cedure to boot DOS from an RK. 


40 This is the same as 10 above, but instead 
of halting, UNIX warm is loaded, 


6) will load a standard UNIX binary paper 
tape into core location O and transfer to 
O. | 


77500 Will load the standard DEC absolute and 
pinary loaders amd transfer to 77500. 


Thus we come to the UNIX warm boot procedure: put 
473000 into the switches, push load address and 
then push start. The alternate switch setting of 
473030 that will load warm UNIX is used as a sig- 
nal to bring up a single user system for special 
purposes, See init(VII). For systems without 4 
rom, UNIX (both warm and cold) have a copy of the 
disk boot program at location 602. This is prob- 
ably a better warm boot procedure because the 
program at 602 also attempts to complete out— 
standing 1/0. 


Cold boots can be accomplished with the Cold UNIX 
program, but they’re not. Thus the Cold UN TX 
slot on the RF may have any program desired. 

This slot is, however, used during a cold boot. 
Mount the UNIX INIT DECtape on drive O positioned 
in the end-zone, Put 473040 into the switches. 
Push load address. Put 1 into the switches. 

Push start. This reads a program called vcboot 
from the tape into core location O and transfers 
to it. veboot then reads 16K words from the 

DECt ape (blocks 4-32) and copies the data to the 
highest 16K words of the RF. Thus this initial- 
izes the read-only part of the RF. vcboot then — 
reads in bos and executes it. bos then reads in 
Cold UNIX and executes that. Cold UNIX halts for 
a last chance before it completely initializes 
the RF file system. Push continue, and Cold UNIX 
will initialize the RF. It then sets into execu- 
tion a user program that reads the DECtape for 
initialization files starting from block 33% 

When this is done, the program executes fetc/init 
which should have been on the tape. 


The INIT tape is made by the program maki running 


de Ot kd 
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under UNIX. maki writes vcboot on block O of 
/dev/tap7. It then copies the RF 16K words 
(using /dev/rf0) onto blocks 1 thru 32. It has 
internally a list of files to be copied from 
block 33 on. This list follows: : 


fetc/init 
/bin/chmod 
/bin/date 
/pin/login 
/bin/is 
/pin/mkdir 
/etc/mount 
/bin/sh 
/bin/tap 


Thus this is the set of programs available after 
a cold boot. init and sh are mandatory. For 
multi-user UNIX, getty and login are also neces- 
sary. mkdir is necessary due to a bug in tap. 
tap and mount are useful to bring in new files. 
As soon as possible, date should be done, That 
leaves ls and chmod as frosting. 


The last link in this incestuous daisy chain is 
the program msys. 


msys char file 
will copy the file file onto the RF read only 


slot specified by the characacter char. Char is 
taken from the following set: 


jmle | 


pue to their rarity of use, maki and msys are 
maintained off line and must be reassembled be- 
fore used, 


FILES /aev/rf0, /dev/tap? 

SEE ALSO init(VII), tap(I), sh(T), mkdir(T) 
DIAGNOSTICS -_— 

BUGS This section is very configuration dependent, 


Thus, it does not describe the boot procedure for 
any one machine, 
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NAME 
SYNOPSIS 


DESCRIPTION 


GETTY (VII) 


getty -- set typewriter mode and get user’s name 


getty is invoked by init (VII) immediately after 
a typewriter is opened following a dial-in. The 
user’s login name is read and the login(I) com- 
mand is called with this name as an argument. 
While reading this name getty attempts to adapt 
the system to the speed and type of terminal 
being used. 


getty initially sets the speed of the interface 
to 150 baud, specifies that raw mode is to be 
used (break on every character), that echo is to 
be suppressed, and either parity allowed. It 
types the login: message (which includes the 
characters which put the 37 Teletype terminal 
into full-duplex and unlock its keyboard). Then 
the user’s name is read, a character at a time. 
If a null character is received, it is assumed to 
be the result of the user pushing the break 
("interrupt ) key. The speed is then changed to 
300 baud and the login: is typed again, this 
time with the appropriate sequence which puts a 
GE TermiNet 300 into full-duplex. This sequence 
is acceptable to other 300 baud terminals also. 
If a subsequent null character is received, the 
speed is changed again. The general approach is 
to cycle through a set of speeds in response to 
null characters caused by breaks. The sequence 
at this installation is 150, 300, and 134.5 baud. 


Detection of IBM 2741s is accomplished while the 
speed is set to 150 baud. The user sends a 2741 
style eot character by pushing the attention 
key or by typing return; at 150 baud, this char- 
acter looks like the ascii ~" (174,). Upon 
receipt of the eot , the system is set to 
operate 2741s and a login: message is typed. 


The user’s name is terminated by a new-line or 
carriage-return character. The latter results in 
the system being set to to treat carriage returns 
appropriately (see stty(II)). 


The user’s name is scanned to see if it contains 
any lower-case alphabetic characters; if not, the 
system is told to map any future upper-case char— 
acters into the corresponding lower-case charac— 
ters. Thus UNIX is usable from upper-case-only 
terminals. 


Finally, login is called with the user’s name as 
argument. 


- {-- 
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FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


fetc/getty 


init(VII), login(I), stty(II) 


GmI , 


ken, 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


GLOB (VIT) 


glob -- generate command arguments 


glob is used to expand arguments to the shell 
containing "*", ‘({’, or ?. It is passed the 
argument list containing the metacharacters; qiob 
expands: the list and calls the command itself. 


founda in /etc/glob 

sh(T) 

“No match , “No command , “No directory 

If any of ’*’, “[", ox "2° occurs both quoted and 
unquoted in the original command line, even the 
quoted metacharacters are expanded. 

glob gives the “No match diagnostic only if no 
arguments at all result. This is never the case 


if there is any argument without a metacharacter. 


amr 


6/15/72 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 


INIT (VII) 


init -—-- process control initialization 


nn am 


init is invoked inside UNIX as the last step in 
the boot procedure. Generally its role is to 
create a process for each typewriter on which a 
user may log in. 


First, init checks to see if the console switches 
contain 173030. (This number is likely to vary 
between systems.) If so, the console typewriter 
tty is opened for reading and writing and the 
shell is invoked immediately. This feature is 
used to bring up a test system, or one which does 
not contain DC-11 communications interfaces. 

When the system is brought up in this way, the 
getty and login routines mentioned below and 
described elsewhere are not needed. 


Otherwise, init does some housekeeping: the mode 
of each DECtape file is changed to 17 (in case | 
the system crashed during a tap command); direc— 
tory /usr is mounted on the RKO disk; directory 
/sys is mounted on the RK1 disk. Also a data- 
phone daemon is spawned to restart any jobs being 
sent. 


Then init forks several times to create a process 
for each typewriter mentioned in an internal 
table. Each of these processes Opens the ap- 
propriate typewriter for reading and writing. 
These channels thus receive file descriptors 0 
and 1, the standard input and output. Opening 
the typewriter will usually involve a delay, 
since the open is not completed until someone is 
dialled in (and carrier established) on the chan- 
nel. Then the process executes the program 
/etc/getty (qeve )o etty will read the user’s 
name and invoke login (q.v.) to log in the user 
and execute the shell. | 


Ultimately the shell will terminate because of an 
end-of-file either typed explicitly or generated 
as a result of hanging up. The main path of 
init, which has been waiting for such an event, 
wakes up and removes the appropriate entry from 
the file utmp, which records current users, and 
makes an entry in wtmp, which maintains a history 
of logins and logouts. Then the appropriate 
typewriter is reopened and getty reinvoked. 


kept in /etc/init; uses J/aev/tap, /dev/tty, 
Jaev/tty?, /tmp/utmp, /tmp/wtmp 


login(I), login(VII), getty(VII), sh(TI), apa(T) 
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DIAGNOSTICS 
BUGS 


OWN ER 
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none possible 
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NAME kbd -- keyboard map 
SYNOPSIS cat /usr/pub/kbd 
DESCRIPTION kbd contains a map to the keyboard for model 37 


Teletype terminals with the extended character 
set feature. If kbd is printed on such a termi- 
nal, the following will appear: 

¢[1234567890-_] \ >awertyuiope asdfghjkl;: zxcvbnm, «/ 


£71234567890—~af¥ > Vv . yet 


cfr ¥#s%e’() =F SOWERTYUIOP* ASDFGHJKL+* ZXCVBNM, -? 


Cy #s%&’() =7 > LAA), Corel aesOor¥rprat® NEwYBnL, -? 


FILES -— 
SEE ALSO ce 
DIAGNOSTICS —— 
BUGS == 


OWN ER jfo 
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NAME 
SYNOPSIS 


DESCRIPTION 


LOGIN, LOGOUT (VIT) 


' logging in and logging out 


UNIX must be called from an appropriate terminal. 
UNIX supports ASCII terminals typified by the 
Teletype M37, the GE Terminet 300, the Memorex 
1240, and various graphical terminals on the one 
hand, and IBM 2741-type terminals on the other. 


Not all installations support all these termi- 
nals. Often the M33/35 Teletype is supported 
instead of the 2741. Depending on the hardware 
installed, most terminals operating at 110, 
134.5, 150, or 300 baud can be accommodated. 


To use UNIX,. it is also necessary to have a valid 
UNIX user ID and (if desired) password. These 
may be obtained, together with the telephone 
number, from the system administrators. 


The same telephone number serves terminals 
operating at all the standard speeds. The dis- 
cussion below applies when the standard speeds of 
434.5 (2741’s) 150 (TTY 37’s) and 300 (Terminet 
300’s) are available. 


When a connection is established via a_150—-baud 
terminal (e.g. TTY 37) UNIX types out "login: 3 
you respond with your user name, and, if request— 
ed, with a password. (The printer is turned off 
while you type the, password. ) Tf the login was 
successful, the @ character is typed by the 
Shell to indicate login is complete and commands 
may be issued. A message of the day may be typed 
if there are any announcements. Also, if there 
is a file called mailbox , you are notified that 
someone has sent you mail. (See the mail com— 
mand. ) 


From a 300—baud terminal, the procedure is 
slightly different. Such terminals often have a 
full-duplex switch, which shoulda be turned on (or 
conversely, half-duplex should be turned off). 
When a connection with UNIX is established, a few 
garbage characters are typed (these are the 
login: message at the wrong speed). You should 
depress the break key; this is a speed- | 
independent signal to UNIX that a 300-baud termi- 
nal is in use. It will type login: (at the 
correct speed this time) and from then on the 
procedure is the same as described above. 


From a 2741, no message will appear. After the 
telephone connection is established, press the 
ATTN” button. UNIX should type login: as 
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FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


LOGIN, LOGOUT (VII) 


described above. If the greeting does not appear 
after a few seconds, hang up and try again; some- 
thing has gone wrong. If a password is required, 
the printer cannot be turned off, so it will 
appear on the paper when you type it. 


For more information, consult getty(VII), which 
discusses the login sequence in more detail, and 
ttyO(IV), which discusses typewriter T/O. 


Logging out is simple by comparison (in fact, 
sometimes too simple). Simply generate an end- 
of-file at Shell level by using the EOT 


character; the "login: message will appear again 
to indicate that you may log in again. 


It is also possible to log out simply by hanging 
up the terminal; this simulates an end-of-file on 
the typewriter. | 


Jetc/motd may contain a message—of—-the-—day. 
init(VII), getty(VII), tty0(IV) 


Hanging up on programs which never read the type~- 
writer or which ignore end-of-files is very 
dangerous; in the worst cases, the programs can 
only be halted by restarting the system. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


MSH (VII) 


msh -—- mini-shell 


msh is a heavily simplified version of the Shell. 
Tt reads one line from the standard input file, 
interprets it as a command, and calls the com—- 


mand. 


The mini-shell supports few of the advanced 
features of the Shell; none of the following 
characters is special: 


>< $\ 3 & 
However, * , i aa and "? are recognized and 


glob is called. The main use of msh is to pro-~ 
vide a command-executing facility for various 


interactive sub-systems. 


found in /etc/msh 


sh, glob 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


TABS (VII) 


tabs -- tab stop set 

cat /usr/pub/tabs 

When printed on a suitable terminal, this file 
will set tab stops at columns 8, 16, 24, 32,5 cece 
Suitable terminals include the Teletype model 37 
and the GE TermiNet 300. 


These tabs stop settings are desirable because 
UNIX assumes them in calculating Gelays.- 


ken 
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